Condividi tramite

variant_explode_outer funzione con 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 annullando l'annidamento di variantExpr utilizzando la semantica esterna.

Sintassi

variant_explode_outer ( variantExpr )

Argomenti

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

Valori restituiti

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

  • pos INT
  • key STRING
  • value VARIANT.

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

Se variantExpr è NULLo non è un VARIANT ARRAY oggetto con almeno un elemento o un OBJECT oggetto con almeno un campo, viene generata una singola riga di NULLs. Per restituire nessuna riga in questo caso, usare la funzione variant_explode .

Esempi

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