EXPLODE_OUTER
功能描述
EXPLODE_OUTER
EXPLODE_OUTER
函数用于将数组或映射类型的表达式展开成多行。与
EXPLODE
EXPLODE
不同的是，当输入为 NULL 或空数组/空映射时，
EXPLODE_OUTER
EXPLODE_OUTER
会保留原始行并输出 NULL 值，而
EXPLODE
EXPLODE
则会直接丢弃该行。
该函数可以直接使用，也可以与
LATERAL VIEW
LATERAL VIEW
搭配使用。
语法
EXPLODE_OUTER(expr)
参数说明
expr
expr
：输入的数组（ARRAY<T>
ARRAY<T>
）或映射（MAP<K, V>
MAP<K, V>
）表达式。
返回结果
- 对于数组类型的输入，返回的结果中每个元素的类型为
T
T
。
- 对于映射类型的输入，返回的结果中包含两个列，分别表示键（
key
key
）和值（value
value
），类型分别为 K
K
和 V
V
。
- 当输入为 NULL 或空数组/空映射时，输出一行 NULL 值。
使用示例
-
展开数组，包含 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 |
+----+------+
-
对比
EXPLODE
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 |
+----+-----+
-
展开映射类型，包含 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
EXPLODE_OUTER
保留原始行并输出 NULL，而 EXPLODE
EXPLODE
会丢弃该行。
- 当输入为空数组
array()
array()
或空映射 map()
map()
时，行为与 NULL 相同：保留原始行并输出 NULL。
EXPLODE_OUTER
EXPLODE_OUTER
常用于 LEFT JOIN 语义的场景，确保即使数组/映射为空或 NULL，主表的行也不会丢失。- 该函数可以直接在 SELECT 中使用，也可以与
LATERAL VIEW
LATERAL VIEW
搭配使用。
