variant_explode_outer
表值函数
适用于: Databricks SQL Databricks Runtime 15.3 及更高版本
使用 outer 语义通过取消嵌套 variantExpr
返回行集。
语法
variant_explode_outer ( variantExpr )
参数
variantExpr
:VARIANT
表达式,表示VARIANT
对象或VARIANT ARRAY
。
返回
由 VARIANT ARRAY
的元素或者 VARIANT
对象的键和值组成的行集。
由 variant_explode
生成的列包括:
pos INT
key STRING
value VARIANT
。
当分解 VARIANT
对象时,输出 key
和 value
列表示对象的键和值。
当分解 VARIANT
数组时,输出 key
始终为 null,输出 value
列表示数组的元素。
如果 variantExpr
是 NULL
,或者既不是具有至少一个元素的 VARIANT ARRAY
,也不是具有至少一个字段的 OBJECT
,则会生成一行 NULL
。
若要在本例中不返回任何行,请使用 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