Condividi tramite

variant_explode funzione a valori di tabella

  • Articolo

Si applica a:segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime 15.3 e versioni successive

Restituisce un set di righe rimuovendo l'annidamento di input.

In Databricks Runtime 16.1 e versioni successive, questa funzione supporta l'invocazione di parametri denominati.

Sintassi

variant_explode ( input )

Argomenti

  • variantExpr VARIANT: espressione che rappresenta un VARIANT oggetto o VARIANT ARRAY.

Valori restituiti

Set di righe composte dagli elementi della VARIANT ARRAYo delle chiavi e dei valori dell'oggetto VARIANT. Le colonne prodotte da variant_explode sono:

  • pos INT
  • key STRING
  • value VARIANT.

Quando si esplode un oggetto VARIANT, l'output key e le colonne value rappresentano le chiavi e i valori dell'oggetto. Quando si esplode un array VARIANT, l'output key è sempre NULLe la colonna value di output rappresenta gli elementi dell'array.

Se input è NULLo non è un VARIANT ARRAY oggetto o VARIANT , non vengono generate righe. Per produrre una singola riga di valori NULL in questo caso, usare la funzione variant_explode_outer.

Esempi

-- 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