Compartir a través de

first_value (función de agregado)

  • Artículo

Se aplica a:casilla marcada como Sí Databricks SQL casilla marcada como Sí Databricks Runtime

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

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: un BOOLEAN literal opcional 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