stack
Função geradora com valor de tabela
Aplica-se a: SQL do Databricks Runtime do Databricks
Separa expr1
, …, exprN
em numRows
linhas.
Sintaxe
stack(numRows, expr1 [, ...] )
Argumentos
numRows
: mUINTEGER
literal maior que 0 especificando o número de linhas produzidas.exprN
: uma expressão de qualquer tipo. O tipo de qualquerexprN
deve corresponder ao tipo deexpr(N+numRows)
.
Retornos
Um conjunto de numRows
linhas que inclui max(1, (N/numRows))
colunas produzidas por essa função.
Uma linha incompleta é preenchida com NULL
s.
Por padrão, as colunas produzidas são nomeadas col0, … col(n-1)
.
stack
é equivalente à VALUES
cláusula.
Aplica-se a: Databricks Runtime 12.1 e versões anteriores:
stack
só pode ser colocado na listaSELECT
como a raiz de uma expressão ou seguindo uma EXIBIÇÃO LATERAL. Ao colocar a função na listaSELECT
, não deve haver nenhuma outra função de gerador na mesma listaSELECT
ou um UNSUPPORTED_GENERATOR. MULTI_GENERATOR será gerado.Aplica-se a: SQL do Databricks Databricks Runtime 12.2 LTS e posteriores:
A invocação a partir da cláusula EXIBIÇÃO LATERAL ou da lista
SELECT
foi preterida. Em vez disso, invoquestack
como uma table_reference.
Exemplos
Aplica-se a: Databricks Runtime 12.1 e versões anteriores:
> SELECT 'hello', stack(2, 1, 2, 3) AS (first, second), 'world';
hello 1 2 world
hello 3 NULL world
> SELECT 'hello', stack(2, 1, 2, 3) AS (first, second), stack(2, 'a', 'b') AS (third) 'world';
Error: UNSUPPORTED_GENERATOR.MULTI_GENERATOR
-- Equivalent usage of VALUES
> SELECT 'hello', s1.*, s2.*, 'world'
FROM VALUES(1, 2), (3, NULL) AS s1(first, second),
VALUES('a'), ('b') AS s2(third);
hello 1 2 a world
hello 3 NULL a world
hello 1 2 b world
hello 3 NULL b world
Aplica-se a: Databricks SQL Databricks Runtime 12.2 LTS e versões posteriores:
> SELECT 'hello', s.*, 'world'
FROM stack(2, 1, 2, 3) AS s(first, second);
hello 1 2 world
hello 3 NULL world
> SELECT 'hello', s1.*, s2.*, 'world'
FROM stack(2, 1, 2, 3) AS s1(first, second),
stack(2, 'a', 'b') AS s2(third);
hello 1 2 a world
hello 3 NULL a world
hello 1 2 b world
hello 3 NULL b world