posexplode_outer
表值生成器函数
适用于: Databricks SQL Databricks Runtime
使用 OUTER
语义,通过取消嵌套具有位置编号的数组来返回行。
语法
posexplode_outer(expr)
参数
expr
:一个 ARRAY 或 MAP 表达式。
返回
由位置和数组元素或者由映射的键和值组成的行集。
由数组的 posexplode_outer
生成的列命名为 pos
和 col
。
映射的列名为 pos
、key
和 value
。
如果 expr
为 NULL
,则为数组值或映射值为 NULL 的单个行。
适用于: Databricks Runtime 12.1 及更早版本:
posexplode_outer
只能作为表达式的根或跟在 LATERAL VIEW 之后放入SELECT
列表中。 将该函数放入SELECT
列表中时,同一个SELECT
列表中不得有其他生成器函数,否则会引发 UNSUPPORTED_GENERATOR.MULTI_GENERATOR。适用于: Databricks SQL Databricks Runtime 12.2 LTS 及更高版本:
从 LATERAL VIEW 子句或
SELECT
列表调用的语法已弃用。 请改为将posexplode_outer
作为 table_reference 调用。
示例
适用于: Databricks Runtime 12.1 及更早版本:
> SELECT posexplode_outer(array(10, 20)) AS elem, 'Spark';
0 10 Spark
1 20 Spark
> SELECT posexplode_outer(map(1, 'a', 2, 'b')) AS (num, val), 'Spark';
0 1 a Spark
1 2 b Spark
> SELECT posexplode_outer(array(1, 2)), posexplode_outer(array(3, 4));
Error: UNSUPPORTED_GENERATOR.MULTI_GENERATOR
适用于: Databricks SQL Databricks Runtime 12.2 LTS 及更高版本:
> SELECT pos, col FROM posexplode_outer(array(10, 20));
0 10
1 20
> SELECT pos, key, value FROM posexplode_outer(map(10, 'a', 20, 'b'));
0 10 a
1 22 b
> SELECT p1.*, p2.* FROM posexplode_outer(array(1, 2)) AS p1, posexplode_outer(array(3, 4)) AS p2;
0 1 0 3
0 1 1 4
1 2 0 3
1 2 1 4
-- Using lateral correlation in Databricks 12.2 and above
> SELECT p1.*, p2.* FROM posexplode_outer(array(1, 2)) AS p1, LATERAL posexplode_outer(array(3 * p1.col, 4 * p1.col)) AS p2;
0 1 0 3
0 1 1 4
1 2 0 6
1 2 1 8