explode_outer
função geradora com valor de tabela
Aplica-se a: Databricks SQL
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
: UmaARRAY
ouMAP
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 NULL
s para os valores da matriz ou do mapa será produzida.
Para não retornar nenhuma linha quando collection
é usar a NULL
).
Aplica-se a:
Databricks Runtime 12.1 e anteriores:
explode_outer
só pode ser colocado na lista deSELECT
como a raiz de uma expressão ou seguindo um LATERAL VIEW. Ao colocar a função na lista deSELECT
, não deve haver nenhuma outra função geradora na mesma listaSELECT
ou UNSUPPORTED_GENERATOR.MULTI_GENERATOR é levantado.Aplica-se a:
Databricks SQL
Databricks Runtime 12.2 LTS e superior:
A invocação da cláusula LATERAL VIEW ou da lista
SELECT
foi descontinuada. Em vez disso, invoqueexplode_outer
como um table_reference.
Exemplos
Aplica-se a: 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: Databricks SQL
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