Функция с табличным значением variant_explode
Область применения: Databricks SQL Databricks Runtime 15.3 и более поздних версий
Возвращает набор строк путем отмены вложения input
.
В Databricks Runtime 16.1 и выше эта функция поддерживает вызов именованных параметров.
Синтаксис
variant_explode ( input )
Аргументы
-
variantExpr
VARIANT
: выражение, представляющееVARIANT
объект илиVARIANT ARRAY
.
Возвраты
Набор строк, состоящих из элементов VARIANT ARRAY
или ключей и значений VARIANT
объекта.
Столбцы, созданные следующими variant_explode
:
pos INT
key 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