Partager via

Fonction sequence

  • Article

S’applique à : case marquée oui Databricks SQL case marquée oui Databricks Runtime

Génère un tableau d’éléments de start à stop (inclus), en incrémentant par step.

Syntaxe

sequence(start, stop [, step] )

Arguments

  • start : expression d’un type numérique intégral, DATE ou TIMESTAMP.
  • stop : si start est numérique, un numérique intégral ; sinon, DATE ou TIMESTAMP.
  • step : expression INTERVAL si start est de type DATE ou TIMESTAMP ; sinon, numérique intégral.

Retours

ARRAY du type le moins commun de start et stop.

Par défaut, step est 1 si start est inférieur ou égal à stop, sinon -1.

La valeur step par défaut est INTERVAL ‘1’ DAY pour la séquence DATE et INTERVAL ‘-1’ DAY pour la séquence TIMESTAMP.

Si start est supérieur à stop, alors step doit être négatif, et vice versa.

Exemples

> 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]