Partilhar via


stack função geradora de valores de tabela

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

Separa , expr1..., exprN em numRows linhas.

Sintaxe

stack(numRows, expr1 [, ...] )

Argumentos

  • numRows: Um INTEGER literal maior que 0 especificando o número de linhas produzidas.
  • exprN: Uma expressão de qualquer tipo. O tipo de qualquer exprN deve corresponder ao tipo de expr(N+numRows).

Devoluções

Um conjunto de numRows linhas, incluindo max(1, (N/numRows)) colunas, produzido por esta função. Uma linha incompleta é preenchida com NULLs.

Por padrão, as colunas produzidas são nomeadas col0, … col(n-1).

stack é equivalente à VALUES cláusula.

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

    stack 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 SELECT, não deve haver nenhuma outra função geradora na mesma lista SELECT ou UNSUPPORTED_GENERATOR.MULTI_GENERATOR é gerado.

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

    A invocação a partir da cláusula LATERAL VIEW ou da lista SELECT é considerada obsoleta. Em vez disso, invoque stack como um table_reference.

Exemplos

Aplica-se a:Marque Sim Databricks Runtime 12.1 e 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:Marque Sim Databricks SQL Marque Sim Databricks Runtime 12.2 LTS e superior:

> 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