Partilhar via

explode_outer função geradora com valor de tabela

  • Artigo

Aplica-se a:Marque Sim Databricks SQL Marque Sim Databricks Runtime

Retorna um conjunto de linhas por desaninhamento de collection usando semântica externa.

No Databricks SQL e no Databricks Runtime 13.3 LTS e superior, esta função suporta a invocação de parâmetros nomeados.

Sintaxe

explode_outer(collection)

Argumentos

  • collection: Uma ARRAY ou MAP expressão.

Devoluções

Um conjunto de linhas composto pelos elementos da matriz ou as chaves e valores do mapa. A coluna produzida por explode_outer de uma matriz é denominada col. As colunas de um mapa são chamadas key e value.

Se collection estiver NULL uma única linha com NULLs para os valores da matriz ou do mapa será produzida. Para não retornar nenhuma linha quando collection é usar a NULL).

  • Aplica-se a:Marque Sim Databricks Runtime 12.1 e anteriores:

    explode_outer só pode ser colocado na lista de SELECT como a raiz de uma expressão ou seguindo um LATERAL VIEW. Ao colocar a função na lista de SELECT, não deve haver nenhuma outra função geradora na mesma lista SELECT ou UNSUPPORTED_GENERATOR.MULTI_GENERATOR é levantado.

  • Aplica-se a:Marque Sim Databricks SQL Marque Sim Databricks Runtime 12.2 LTS e superior:

    A invocação da cláusula LATERAL VIEW ou da lista SELECT foi descontinuada. Em vez disso, invoque explode_outer como um table_reference.

Exemplos

Aplica-se a:Marque Sim Databricks Runtime 12.1 e anteriores:

> SELECT explode_outer(array(10, 20)) AS elem, 'Spark';
 10 Spark
 20 Spark

> SELECT explode_outer(collection => array(10, 20)) AS elem, 'Spark';
 10 Spark
 20 Spark

> SELECT explode_outer(map(1, 'a', 2, 'b')) AS (num, val), 'Spark';
 1   a   Spark
 2   b   Spark

> SELECT explode_outer(cast(NULL AS array<int>)), 'Spark';
 NULL   Spark

> SELECT explode_outer(array(1, 2)), explode_outer(array(3, 4));
  Error: UNSUPPORTED_GENERATOR.MULTI_GENERATOR

-- The difference between explode() and explode_outer() is that explode_outer() returns NULL if the array is NULL.
> SELECT explode_outer(c1) AS elem, 'Spark' FROM VALUES(array(10, 20)), (null) AS T(c1);
 10   Spark
 20   Spark
 NULL Spark

> SELECT explode(c1) AS elem, 'Spark' FROM VALUES(array(10, 20)), (null) AS T(c1);
 10 Spark
 20 Spark

Aplica-se a:Marque Sim Databricks SQL Marque Sim Databricks Runtime 12.2 LTS e superior:

> SELECT elem, 'Spark' FROM explode_outer(array(10, 20)) AS t(elem);
 10 Spark
 20 Spark

> SELECT num, val, 'Spark' FROM explode_outer(map(1, 'a', 2, 'b')) AS t(num, val);
 1   a   Spark
 2   b   Spark

> SELECT * FROM explode_outer(array(1, 2)), explode_outer(array(3, 4));
 1   3
 1   4
 2   3
 2   4

> SELECT * FROM explode_outer(cast(NULL AS array<int>));
 NULL

-- Using lateral correlation in Databricks 12.2 and above
> SELECT * FROM explode_outer(array(1, 2)) AS t, LATERAL explode_outer(array(3 * t.col, 4 * t.col));
 1   3
 1   4
 2   6
 2   8