Condividi tramite

funzione a valori variant_explodetable

  • Articolo

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

Restituisce set righe de-annidando 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

Un set di righe composte dagli elementi del VARIANT ARRAYo delle chiavi e degli values dell'oggetto VARIANT. I columns prodotti da variant_explode sono:

  • pos INT
  • key STRING
  • value VARIANT.

Quando si esplode un oggetto VARIANT, l'output key e valuecolumns rappresentano le chiavi e values dell'oggetto. Quando si espande un array di VARIANT, l'output key è sempre NULLe l'output valuecolumn 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 NULLvalues in questo caso, usa 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