explode_outer
table的值生成函式
適用於:Databricks SQL Databricks Runtime
使用外部語意取消巢狀 collection
,傳回數據列的 set。
在 Databricks SQL 和 Databricks Runtime 13.3 LTS 和更新版本中,此函式支援 具名參數調用。
語法
explode_outer(collection)
引數
-
collection
ARRAY
:或MAP
表達式。
傳回
由陣列元素或索引鍵和地圖 values 所組成的數據列 set。
陣列 explode_outer
所產生的 column 會命名為 col
。
地圖的 columns 稱為 key
與 value
。
如果 collection
是 NULL
時,將產生一個具有 NULL
的單一行用於陣列或對映 values。
使用爆炸函式時collection
NULL
,不傳回任何數據列。
適用於: Databricks Runtime 12.1 和更早版本:
explode_outer
只能放在SELECT
list 中作為一個表示式的根,或在 LATERAL VIEW之後。 當將函式放置於SELECT
list 時,同一個SELECT
list 或 中不得有其他的產生器函式,否則將引發 UNSUPPORTED_GENERATOR.MULTI_GENERATOR 錯誤。適用於: Databricks SQL Databricks Runtime 12.2 LTS 和更新版本:
從 LATERAL VIEW 子句調用 或
SELECT
list 已被取代。 請改為叫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