Partager via


Fonction de fenêtre analytique lead

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

Retourne la valeur de expr à partir d’une ligne suivante dans la partition. Cette fonction est similaire à lag(expr, -offset, default).

Syntaxe

lead(expr [, offset [, default] ] ) [ IGNORE NULLS | RESPECT NULLS ] OVER clause

Arguments

  • expr : Expression de tout type.
  • offset : littéral ENTIER facultatif spécifiant le décalage.
  • default : expression du même type que expr.
  • IGNORE NULLS ou RESPECT NULLS : quand IGNORE NULLS est spécifié, toute valeur expr NULL est ignorée. Par défaut, il s’agit de RESPECT NULLS.
  • Clause OVER : clause décrivant le fenêtrage. Consultez les Fonctions de fenêtre.

Retours

Le résultat est du type d’expr.

Si offset est positif, la valeur provient de la ligne qui suit la ligne actuelle par le offset spécifié dans la clause ORDER BY de la clause OVER. Un décalage de 0 utilise la valeur de la ligne actuelle. Un décalage négatif utilise la valeur d’une ligne qui précède la ligne actuelle. Si vous ne le spécifiez pas offset, la valeur par défaut est 1 à la ligne qui suit immédiatement.

S’il n’existe aucune ligne à l’offset spécifié au sein de la partition, le default spécifié est utilisé. Le default par défaut est NULL. Une clause ORDER BY doit être fournie.

Exemples

> SELECT a, b, lead(b) OVER (PARTITION BY a ORDER BY b)
    FROM VALUES ('A1', 2), ('A1', 1), ('A2', 3), ('A1', 1) tab(a, b);
 A1 1   1
 A1 1   2
 A1 2   NULL
 A2 3   NULL