Compartir a través de

variant_explode_outer función con valores de tabla

  • Artículo

Se aplica a:casilla marcada como Sí Databricks SQL casilla marcada como Sí Databricks Runtime 15.3 y versiones posteriores

Devuelve un conjunto de filas anulando el anidamiento de variantExpr mediante semántica externa.

Sintaxis

variant_explode_outer ( variantExpr )

Argumentos

  • variantExpr: Una expresión VARIANT, que representa un VARIANT objeto o VARIANT ARRAY.

Devoluciones

Un conjunto de filas compuestas por los elementos de la matriz VARIANT ARRAYo las claves y los valores del mapaVARIANT. Las columnas generadas por variant_explode son:

  • pos INT
  • key STRING
  • value VARIANT.

Al explotar un VARIANT objeto, la salida key y value las columnas representan las claves y los valores del objeto. Al explotar una VARIANT matriz, la salida key siempre es null y la columna de salida value representa los elementos de la matriz.

Si variantExpr es NULL, o no es con VARIANT ARRAY al menos un elemento o OBJECT con al menos un campo, se genera una sola fila de NULLs. Para devolver ninguna fila en este caso, use la función variant_explode.

Ejemplos

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