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