適用対象:
Databricks SQL
Databricks Runtime 15.3 以降
外部セマンティクスを使用して入れ子を解除した variantExpr により、行のセットを返します。
構文
variant_explode_outer ( variantExpr )
引数
-
variantExpr:VARIANTオブジェクトまたはVARIANTを表すVARIANT ARRAY式。
返品
VARIANT ARRAY の要素、または VARIANT オブジェクトのキーと値で構成される行のセット。
variant_explode によって生成される列は次のとおりです。
pos INTkey STRING-
value VARIANT=
VARIANT オブジェクトを分解すると、出力の key および value 列はオブジェクトのキーと値を表します。
VARIANT 配列を分解すると、出力の key は常に null 値で、出力の value 列は配列の要素を表します。
variantExpr が NULL である場合、または少なくとも 1 つの要素を含む VARIANT ARRAY または少なくとも 1 つのフィールドを含む OBJECT のいずれでもない場合、NULL の 1 行が生成されます。
この場合、行を返さない場合は 、variant_explode 関数を使用します。
例
-- Simple example
> SELECT *
FROM variant_explode_outer(parse_json('[1, "a", {"b": "hello"}]'));
pos key value
--- ---- -------------
0 NULL 1
1 NULL "a"
2 NULL {"b":"hello"}
> SELECT *
FROM variant_explode_outer(parse_json('{"foo":1,"bar":"hello"}'));
pos key value
--- ---- -------------
0 bar "hello"
1 foo 1
-- null input
> SELECT value FROM variant_explode_outer(null) AS t(pos, key, value);
null
-- Not an array or object input
> SELECT value FROM variant_explode_outer(parse_json('123')) AS t(pos, key, value);
null
-- Using lateral correlation
> SELECT t.value AS outer, u.value AS inner
FROM variant_explode_outer(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