Fonction d’agrégation first_value

S’applique à : Databricks SQL Databricks Runtime

Retourne la première valeur de expr pour un groupe de lignes. Cette fonction est un synonyme de first la fonction d’agrégation.

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 facultatif BOOLEAN qui a la valeur false par défaut.
• 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

> SELECT first_value(col) IGNORE NULLS FROM VALUES (10), (5), (NULL) AS tab(col);
 5

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

Rubriques connexes

• min fonction d’agrégation
• max fonction d’agrégation
• last fonction d’agrégation
• last_value fonction d’agrégation
• first fonction d’agrégation
• Fonctions Windows