posexplode
テーブル値ジェネレーター関数
適用対象: Databricks SQL Databricks Runtime
位置の番号付けで expr
の入れ子を解除することにより、行のセットを返します。
構文
posexplode(expr)
引数
expr
:ARRAY
またはMAP
式。
戻り値
配列の位置と要素、またはマップのキーと値で構成される行のセット。
配列の posexplode
によって生成される列の名前は pos
と col
です。
マップの列は、pos
、key
、value
と呼ばれます。
expr
が NULL
の場合、行は生成されません。
適用対象: Databricks Runtime 12.1 以前:
posexplode
は式のルートとして、または LATERAL VIEW に続く場合にのみ、SELECT
リストに配置できます。 関数をSELECT
リストに配置する場合、同じSELECT
リストに他のジェネレーター関数が存在してはいけません。存在する場合は、UNSUPPORTED_GENERATOR.MULTI_GENERATOR が発生します。適用対象: Databricks SQL Databricks Runtime 12.2 LTS 以上:
LATERAL VIEW 句または
SELECT
リストからの呼び出しは非推奨です。 代わりに、table_reference としてposexplode
を呼び出します。
例
適用対象: Databricks Runtime 12.1 以前:
> SELECT posexplode(array(10, 20)) AS elem, 'Spark';
0 10 Spark
1 20 Spark
> SELECT posexplode(map(1, 'a', 2, 'b')) AS (num, val), 'Spark';
0 1 a Spark
1 2 b Spark
> SELECT posexplode(array(1, 2)), posexplode(array(3, 4));
Error: UNSUPPORTED_GENERATOR.MULTI_GENERATOR
適用対象: Databricks SQL Databricks Runtime 12.2 LTS 以降:
> SELECT pos, col FROM posexplode(array(10, 20));
0 10
1 20
> SELECT pos, key, value FROM posexplode(map(10, 'a', 20, 'b'));
0 10 a
1 22 b
> SELECT p1.*, p2.* FROM posexplode(array(1, 2)) AS p1, posexplode(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(array(1, 2)) AS p1, LATERAL posexplode(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