Fonction d’agrégation first

  • 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. La fonction est un synonyme de la fonction d’agrégation first_value.

Syntaxe

first(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(col) FROM VALUES (10), (5), (20) AS tab(col);
 10

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

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