first_value (función de agregado)

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 de first función de agregado.

Sintaxis

first_value(expr[, ignoreNull]) [FILTER ( WHERE cond ) ] [ IGNORE NULLS | RESPECT NULLS ]

También puede invocar esta función como una función de ventana mediante la OVER cláusula .

Argumentos

  • expr: una expresión de cualquier tipo.
  • ignoreNull: literal opcional BOOLEAN que tiene como valor predeterminado false.
  • cond: expresión booleana opcional que filtra las filas usadas para la agregación.
  • IGNORE NULLS o RESPECT NULLS: cuando se usa IGNORE NULLS o se establece en ignoreNulltrue, la función omite cualquier expr valor 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);
 10

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