first_value 聚合函数 (Databricks SQL)

返回一组行的第一个 expr 值。

语法

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

参数

  • expr:任何类型的表达式。
  • ignoreNull:默认为 false 的可选布尔文本。
  • cond:一个可选的布尔表达式,可筛选用于聚合的行。

返回

结果的类型与 expr 相同。

如果 ignoreNull 为 true,则除非整个值组为 NULL,否则函数仅返回非 null 值。 ignoreNull 的默认值为 false。

first_value 是 first 聚合函数 (Databricks SQL) 的同义词。

此函数为非确定性函数。

示例

> 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