EXPLODE_OUTER 函数

功能描述

EXPLODE_OUTER 函数用于将数组或映射类型的表达式展开成多行。与 EXPLODE 不同的是，当输入为 NULL 或空数组/空映射时，EXPLODE_OUTER 会保留原始行并输出 NULL 值，而 EXPLODE 则会直接丢弃该行。

该函数可以直接使用，也可以与 LATERAL VIEW 搭配使用。

语法

EXPLODE_OUTER(expr)

参数说明

• expr：输入的数组（ARRAY<T>）或映射（MAP<K, V>）表达式。

返回结果

• 对于数组类型的输入，返回的结果中每个元素的类型为 T。
• 对于映射类型的输入，返回的结果中包含两个列，分别表示键（key）和值（value），类型分别为 K 和 V。
• 当输入为 NULL 或空数组/空映射时，输出一行 NULL 值。

使用示例

1. 展开数组，包含 NULL 输入的情况：

   SELECT id, col
   FROM VALUES (1, array(10, 20)), (2, NULL), (3, array()) AS t(id, arr)
   LATERAL VIEW EXPLODE_OUTER(arr) lv AS col;
   +----+------+
   | id | col  |
   +----+------+
   | 1  | 10   |
   | 1  | 20   |
   | 2  | NULL |
   | 3  | NULL |
   +----+------+
   

2. 对比 EXPLODE（会丢弃 NULL 和空数组的行）：

   -- 使用 EXPLODE：NULL 和空数组的行被丢弃
   SELECT id, col
   FROM VALUES (1, array(10, 20)), (2, NULL), (3, array()) AS t(id, arr)
   LATERAL VIEW EXPLODE(arr) lv AS col;
   +----+-----+
   | id | col |
   +----+-----+
   | 1  | 10  |
   | 1  | 20  |
   +----+-----+
   

3. 展开映射类型，包含 NULL 输入：

   SELECT id, key, value
   FROM VALUES (1, map('a', 1, 'b', 2)), (2, NULL) AS t(id, m)
   LATERAL VIEW EXPLODE_OUTER(m) lv AS key, value;
   +----+------+-------+
   | id | key  | value |
   +----+------+-------+
   | 1  | a    | 1     |
   | 1  | b    | 2     |
   | 2  | NULL | NULL  |
   +----+------+-------+
   

注意事项

• 当输入为 NULL 时，EXPLODE_OUTER 保留原始行并输出 NULL，而 EXPLODE 会丢弃该行。
• 当输入为空数组 array() 或空映射 map() 时，行为与 NULL 相同：保留原始行并输出 NULL。
• EXPLODE_OUTER 常用于 LEFT JOIN 语义的场景，确保即使数组/映射为空或 NULL，主表的行也不会丢失。
• 该函数可以直接在 SELECT 中使用，也可以与 LATERAL VIEW 搭配使用。