explode_outer
數據表值產生器函式
適用於:Databricks SQL
Databricks Runtime
使用外部語意,透過將 collection
解嵌來傳回一組行。
在 Databricks SQL 和 Databricks Runtime 13.3 LTS 和更新版本中,此函式支援 具名參數調用。
語法
explode_outer(collection)
引數
-
collection
ARRAY
:或MAP
表達式。
傳回
一組由陣列元素或映射的鍵和值組成的數據列。
陣列 explode_outer
所產生的欄被命名為 col
。
地圖的資料列稱為 key
與 value
。
如果 collection
NULL
會產生陣列或對應值具有 NULL
s 的單一數據列。
使用爆炸函式時collection
NULL
,不傳回任何數據列。
適用於:
Databricks Runtime 12.1 和更早版本:
explode_outer
只能放在SELECT
清單中作為運算式的根節點,或跟在 LATERAL VIEW之後。 將函式放在SELECT
清單中時,在相同的SELECT
清單中或 UNSUPPORTED_GENERATOR 中不得有其他產生器函式。MULTI_GENERATOR引发。適用於:
Databricks SQL
Databricks Runtime 12.2 LTS 和更新版本:
從
SELECT
已被棄用。 請改為叫explode_outer
用作為 table_reference。
範例
適用於: 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