variant_explode_outer
табличное значение функции
Область применения: Databricks SQL Databricks Runtime 15.3 и более поздних версий
Возвращает набор строк путем отмены вложения 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
s.
Чтобы вернуть строки в этом случае, используйте функцию 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
Связанные функции
-
variant_explode табличное значение функции