posexplode
table- função geradora valorizada
Aplica-se a: Databricks SQL Databricks Runtime
Retorna uma set de linhas ao desaninhar expr
com a numeração das posições.
No Databricks Runtime 16.1 e superior, esta função suporta invocação de parâmetro nomeado.
Sintaxe
posexplode(collection)
Argumentos
-
collection
: UmaARRAY
ouMAP
expressão.
Devoluções
Um set de linhas composto pelas posições e elementos da matriz ou pelas chaves e values do mapa.
Os columns produzidos por posexplode
de uma matriz são denominados pos
e col
.
Os columns de um mapa são chamados pos
, key
e value
.
Se collection
não houver NULL
linhas são produzidas.
Aplica-se a: Databricks Runtime 12.1 e anteriores:
posexplode
só pode estar noSELECT
list como a raiz de uma expressão ou seguindo uma LATERAL VIEW. Ao colocar a função noSELECT
list, não deve haver outra função geradora na mesmaSELECT
list ou , caso contrário, UNSUPPORTED_GENERATOR.MULTI_GENERATOR é acionada.Aplica-se a: Databricks SQL Databricks Runtime 12.2 LTS e superior:
A invocação da cláusula LATERAL VIEW ou do
SELECT
list está obsoleta. Em vez disso, invoqueposexplode
como um table_reference.
Exemplos
Aplica-se a: Databricks Runtime 12.1 e anteriores:
> SELECT posexplode(array(10, 20)) AS elem, 'Spark';
0 10 Spark
1 20 Spark
> SELECT posexplode(map(1, 'a', 2, 'b')) AS (num, val), 'Spark';
0 1 a Spark
1 2 b Spark
> SELECT posexplode(array(1, 2)), posexplode(array(3, 4));
Error: UNSUPPORTED_GENERATOR.MULTI_GENERATOR
Aplica-se a: Databricks SQL Databricks Runtime 12.2 LTS e superior:
> SELECT pos, col FROM posexplode(array(10, 20));
0 10
1 20
> SELECT pos, key, value FROM posexplode(map(10, 'a', 20, 'b'));
0 10 a
1 22 b
> SELECT p1.*, p2.* FROM posexplode(array(1, 2)) AS p1, posexplode(array(3, 4)) AS p2;
0 1 0 3
0 1 1 4
1 2 0 3
1 2 1 4
-- Using lateral correlation in Databricks 12.2 and above
> SELECT p1.*, p2.* FROM posexplode(array(1, 2)) AS p1, LATERAL posexplode(array(3 * p1.col, 4 * p1.col)) AS p2;
0 1 0 3
0 1 1 4
1 2 0 6
1 2 1 8