適用於:
Databricks SQL
Databricks Runtime 15.3 和更新版本
透過展開 input邏輯結構來傳回一組數據列。
在 Databricks SQL 和 Databricks Runtime 16.1 和更新版本中,此函式支援 具名參數調用。
語法
variant_explode ( input )
引數
-
variantExprVARIANT:表達式,表示VARIANT物件或VARIANT ARRAY。
傳回
由 VARIANT ARRAY專案的元素或 VARIANT 物件的鍵和值所組成的一組數據行。
variant_explode產生的欄位如下:
pos INTkey STRING-
value VARIANT。
當 VARIANT 物件展開時,輸出的 key 和 value 欄位代表該物件的鍵和值。
當展開 VARIANT 陣列時,輸出 key 總是會是 NULL,而輸出 value 欄代表陣列的元素。
如果 input 是 NULL,或不是 VARIANT ARRAY 或 VARIANT 物件,則不會產生任何數據列。
若要在此案例中產生單一列的 NULL 值,請使用 variant_explode_outer 函式。
範例
-- Simple example
> SELECT *
FROM variant_explode(parse_json('[1, "a", {"b": "hello"}]'));
pos key value
--- ---- -------------
0 NULL 1
1 NULL "a"
2 NULL {"b":"hello"}
> SELECT *
FROM variant_explode(parse_json('{"foo":1,"bar":"hello"}'));
pos key value
--- ---- -------------
0 bar "hello"
1 foo 1
-- Using lateral correlation
> SELECT t.value AS outer, u.value AS inner
FROM variant_explode(parse_json('[[1, 2], [3, 4]]')) AS t,
LATERAL variant_explode(t.value) AS u;
outer inner
----- -----
[1,2] 1
[1,2] 2
[3,4] 3
[3,4] 4