Fonction d’agrégation first_value

  • Article

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

Retourne la première valeur de expr pour un groupe de lignes. Cette fonction est un synonyme de la première fonction aggregate.

Syntaxe

first_value(expr[, ignoreNull]) [FILTER ( WHERE cond ) ]

Cette fonction peut également être appelée en tant que fonction de fenêtre à l’aide de la clause OVER.

Arguments

  • expr : Expression de tout type.
  • ignoreNull : littéral BOOLEAN facultatif dont la valeur par défaut est false.
  • cond : expression booléenne facultative qui filtre les lignes utilisées pour l’agrégation.
  • IGNORE NULLS ou RESPECT NULLS : quand IGNORE NULLS est utilisé ou quand ignoreNull est true, toute valeur d’expr NULL est ignorée. Par défaut, il s’agit de RESPECT NULLS.

Retours

Le résultat a le même type que expr.

Cette fonction n’est pas déterministe.

Exemples

> SELECT first_value(col) FROM VALUES (10), (5), (20) AS tab(col);
 10

> SELECT first_value(col) FROM VALUES (NULL), (5), (20) AS tab(col);
 NULL

> SELECT first_value(col, true) FROM VALUES (NULL), (5), (20) AS tab(col);
 5