Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 ) ] [ 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 opcionalBOOLEANque tiene como valor predeterminado false. -
cond: expresión booleana opcional que filtra las filas usadas para la agregación. -
IGNORE NULLSoRESPECT NULLS: cuando se usaIGNORE NULLSo se establece enignoreNulltrue, la función omite cualquierexprvalor que sea NULL. El valor predeterminado esRESPECT 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