first_value 聚合函数

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

语法

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

参数

  • expr:任何类型的表达式。
  • ignoreNull:默认为 false 的可选布尔文本。 ignoreNull 的默认值为 false。
  • cond:一个可选的布尔表达式,可筛选用于聚合的行。
  • IGNORE NULLSRESPECT NULLS或 : IGNORE NULLS 使用 或 ignoreNulltrue ,将忽略为 NULL expr 的任何值。 默认为 RESPECT NULLS

返回

结果的类型与 expr 相同。

first_value 是 first 聚合函数的同义词。

此函数为非确定性函数。

示例

> 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) IGNORE NULLS FROM VALUES (NULL), (5), (20) AS tab(col);
 5