first_value (función de agregado)

Se aplica a: Databricks SQL Databricks Runtime

Devuelve el primer valor de expr para un grupo de filas. Esta función es un sinónimo de first función de agregado.

Sintaxis

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

Esta función también se puede invocar como una función de ventana mediante la cláusula OVER.

Argumentos

• expr: una expresión de cualquier tipo.
• ignoreNull: literal opcional BOOLEAN que tiene como valor predeterminado false.
• cond: una expresión booleana opcional que filtra las filas usadas para la agregación.
• IGNORE NULLS o RESPECT NULLS: cuando se usa IGNORE NULLS o ignoreNull es true se omite cualquier valor expr que sea NULL. El valor predeterminado es RESPECT NULLS.

Devoluciones

El resultado tiene el mismo tipo que expr.

Esta función no es determinista.

Ejemplos

> 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

Temas relacionados

• min función de agregación
• max función de agregación
• last función de agregación
• last_value función de agregación
• first función de agregación
• Funciones de ventana