variant_explode
funkcja wartości tabeli
Dotyczy: Databricks SQL Databricks Runtime 15.3 i nowsze
Zwraca zestaw wierszy przez usuwanie zagnieżdżania input
.
W środowisku Databricks Runtime 16.1 lub nowszym ta funkcja obsługuje wywołanie parametrów o nazwie
Składnia
variant_explode ( input )
Argumenty
-
variantExpr
VARIANT
: wyrażenie reprezentująceVARIANT
obiekt lubVARIANT ARRAY
.
Zwraca
Zestaw wierszy składający się z elementów VARIANT ARRAY
lub kluczy i wartości obiektu VARIANT
.
Kolumny generowane przez variant_explode
to:
pos INT
key STRING
-
value VARIANT
.
Podczas eksplodowania obiektu VARIANT
kolumny wyjściowe key
i value
reprezentują klucze i wartości obiektu.
Podczas eksplodowania tablicy VARIANT
dane wyjściowe key
są zawsze NULL
, a kolumna value
danych wyjściowych reprezentuje elementy tablicy.
Jeśli input
element to NULL
, lub nie jest obiektem VARIANT ARRAY
lub VARIANT
, nie są generowane żadne wiersze.
Aby w tym przypadku utworzyć jeden wiersz wartości NULL
, użyj funkcji variant_explode_outer.
Przykłady
-- 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