次の方法で共有

posexplode_outer テーブル値ジェネレーター関数

  • [アーティクル]

適用対象:「はい」のチェック マーク Databricks SQL 「はい」のチェック マーク Databricks Runtime

OUTER セマンティクスを使用した位置の番号付けで配列の入れ子を解除することにより、行を返します。

Databricks Runtime 16.1 以降では、この関数は名前付きパラメーター呼び出し をサポートしています。

構文

posexplode_outer(collection)

引数

  • collection: 配列またはマップ式。

戻り値

配列の位置と要素、またはマップのキーと値で構成される行のセット。 配列の posexplode_outer によって生成される列の名前は pos と col です。 マップの列は、pos、key、value と呼ばれます。

collection が NULL の場合は、配列またはマップ値に NULL が含まれる単一の行。

  • 適用対象:「はい」のチェック マーク Databricks Runtime 12.1 以前:

    posexplode_outer は式のルートとして、または SELECT に続く場合にのみ、 リストに配置できます。 関数を SELECT リストに配置する場合、同じ SELECT リストに他のジェネレーター関数が存在してはいけません。存在する場合は、UNSUPPORTED_GENERATOR.MULTI_GENERATOR が発生します。

  • 適用対象:check marked yes Databricks SQL 「はい」のチェック マーク Databricks Runtime 12.2 LTS 以上:

    LATERAL VIEW 句または SELECT リストからの呼び出しは非推奨です。 代わりに、posexplode_outer として を呼び出します。

例

適用対象:「はい」のチェック マーク 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

適用対象:check marked yes 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