Partager via


Fonction de fenêtre analytique nth_value

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

Renvoie la valeur d’un offset spécifique dans la fenêtre.

Syntaxe

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

Arguments

  • expr : Expression de tout type.
  • offset : littéral INTEGER supérieur à 0.
  • IGNORE NULLS ou RESPECT NULLS : quand IGNORE NULLS est utilisé, les valeurs de expr qui sont Null sont ignorées dans le comptage. 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 type de résultat correspond au type expr.

La fonction de fenêtre renvoie la valeur de expr au niveau de la ligne en offsetème position à partir du début du cadre de la fenêtre.

À défaut de offsetème ligne, renvoie NULL.

Vous devez utiliser la clause ORDER BY avec cette fonction. Si l’ordre n’est pas unique, le résultat n’est pas déterministe.

Exemples

> SELECT a, b, nth_value(b, 2) 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   1
 A1 2   1
 A2 3   NULL