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 及更高版本：

  从 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 及更高版本：

> 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

相关函数

• explode 表值生成器函数
• explode_outer 表值生成器函数
• inline 表值生成器函数
• inline_outer 表值生成器函数
• posexplode 表值生成器函数