Compartilhar via

Função sequence

  • Artigo

Aplica-se a: marca de seleção positiva SQL do Databricks marca de seleção positiva Runtime do Databricks

Gera uma matriz de elementos de start a stop (inclusive), com incrementos de step.

Sintaxe

sequence(start, stop [, step] )

Argumentos

  • start: Uma expressão de um tipo numérico integral, DATE ou TIMESTAMP.
  • stop: Se start for numérico integral, um DATE ou outro TIMESTAMP.
  • step: Uma expressão INTERVAL se start for um DATE ou TIMESTAMP, ou um numérico integral, caso contrário.

Retornos

Um tipo ARRAY de menos comum de start e stop.

Por padrão step, será 1 se start for menor ou igual a stop, caso contrário, -1.

Para DATE ou TIMESTAMP o padrão de sequencias sequências step é INTERVAL '1' DAY e INTERVAL '-1' DAY, respectivamente.

Se start for maior que stop, então step deverá ser negativo e vice-versa.

Exemplos

> SELECT sequence(1, 5);
 [1,2,3,4,5]

> SELECT sequence(5, 1);
 [5,4,3,2,1]

> SELECT sequence(DATE'2018-01-01', DATE'2018-03-01', INTERVAL 1 MONTH);
 [2018-01-01,2018-02-01,2018-03-01]