explode_outertable値ジェネレーター関数
適用対象:
Databricks SQL Databricks Runtime
外部セマンティクスを使用して入れ子を解除した collection により、行のセットを返します。
Databricks SQL および Databricks Runtime 13.3 LTS 以降では、この関数は名前付きパラメータ呼び出しをサポートしています。
構文
explode_outer(collection)
引数
collection:ARRAYまたはMAP式。
返品
配列の要素、またはマップのキーとvalues値で構成される行のセット。
配列の explode_outer によって生成される column は、colという名前です。
マップの columns は、key と valueと呼ばれます。
collection が NULL 場合は、配列またはマップ values の NULLs を持つ 1 つの行が生成されます。
collectionがNULLされたときに行を返さない場合は、explode()関数を使用します。
適用対象:
Databricks Runtime 12.1 以前:explode_outerは、式のルートとして、または LATERAL VIEWの後にのみSELECTlist に配置できます。 関数をSELECTlist に配置する場合、同じSELECTlist または UNSUPPORTED_GENERATOR に他のジェネレーター関数は存在しない必要があります。MULTI_GENERATORが発生します。適用対象:
Databricks SQL Databricks Runtime 12.2 LTS 以上:LATERAL VIEW 句 または
SELECTlist からの呼び出しは非推奨です。 代わりに、explode_outerとして を呼び出します。
例
適用対象: Databricks Runtime 12.1 以前:
> SELECT explode_outer(array(10, 20)) AS elem, 'Spark';
10 Spark
20 Spark
> SELECT explode_outer(collection => array(10, 20)) AS elem, 'Spark';
10 Spark
20 Spark
> SELECT explode_outer(map(1, 'a', 2, 'b')) AS (num, val), 'Spark';
1 a Spark
2 b Spark
> SELECT explode_outer(cast(NULL AS array<int>)), 'Spark';
NULL Spark
> SELECT explode_outer(array(1, 2)), explode_outer(array(3, 4));
Error: UNSUPPORTED_GENERATOR.MULTI_GENERATOR
-- The difference between explode() and explode_outer() is that explode_outer() returns NULL if the array is NULL.
> SELECT explode_outer(c1) AS elem, 'Spark' FROM VALUES(array(10, 20)), (null) AS T(c1);
10 Spark
20 Spark
NULL Spark
> SELECT explode(c1) AS elem, 'Spark' FROM VALUES(array(10, 20)), (null) AS T(c1);
10 Spark
20 Spark
適用対象: Databricks SQL Databricks Runtime 12.2 LTS 以上:
> SELECT elem, 'Spark' FROM explode_outer(array(10, 20)) AS t(elem);
10 Spark
20 Spark
> SELECT num, val, 'Spark' FROM explode_outer(map(1, 'a', 2, 'b')) AS t(num, val);
1 a Spark
2 b Spark
> SELECT * FROM explode_outer(array(1, 2)), explode_outer(array(3, 4));
1 3
1 4
2 3
2 4
> SELECT * FROM explode_outer(cast(NULL AS array<int>));
NULL
-- Using lateral correlation in Databricks 12.2 and above
> SELECT * FROM explode_outer(array(1, 2)) AS t, LATERAL explode_outer(array(3 * t.col, 4 * t.col));
1 3
1 4
2 6
2 8