Função com valor de tabela variant_explode_outer

  • Artigo

Aplica-se a: marca de seleção positiva Databricks SQL marca de seleção positiva Databricks Runtime 15.3 e posterior

Retorna um conjunto de linhas com o desaninhamento de variantExpr usando semântica externa.

Sintaxe

variant_explode_outer ( variantExpr )

Argumentos

  • variantExpr: uma expressão VARIANT, representando um objeto VARIANT ou VARIANT ARRAY.

Devoluções

Um conjunto de linhas composto pelos elementos da VARIANT ARRAY ou as chaves e valores do objeto VARIANT. As colunas produzidas por variant_explode são:

  • pos INT
  • key STRING
  • value VARIANT.

Ao explodir um objeto VARIANT, a saída key e as colunas value representam as chaves e os valores do objeto. Ao explodir uma matriz VARIANT, a saída key é sempre nula, e a coluna de saída value representa os elementos da matriz.

Se variantExpr for NULL, ou não for um VARIANT ARRAY com pelo menos um elemento ou então um OBJECT com pelo menos um campo, apenas uma linha de NULLs será produzida. Para retornar nenhuma linha nesse caso, use a função variant_explode.

Exemplos

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