FIRST_VALUE

first_value(expr [, ignoreNulls]) [FILTER (WHERE condition)] first(expr [, ignoreNulls]) [FILTER (WHERE condition)]

功能描述

FIRST_VALUE

FIRST_VALUE

函数用于返回聚合组或窗口中的第一个值。可以选择是否忽略

NULL

NULL

值。

first

first

是

first_value

first_value

的别名。

参数说明

```
expr
```
expr
：任意类型的表达式，要获取其第一个值。
```
ignoreNulls
```
ignoreNulls
：可选的布尔值参数，默认为
```
false
```
false
。
- ```
false
```
  false
  （默认）：返回第一个值，即使是
```
NULL
```
  NULL
- ```
true
```
  true
  ：忽略
```
NULL
```
  NULL
  值，返回第一个非
```
NULL
```
  NULL
  值

返回类型

返回与输入表达式相同的数据类型。
返回聚合组或窗口中的第一个值。

注意事项

如果所有值都是
```
NULL
```
NULL
（且
```
ignoreNulls
```
ignoreNulls
为
```
true
```
true
），返回
```
NULL
```
NULL
。
如果输入为空集，返回
```
NULL
```
NULL
。
值的顺序取决于数据的输入顺序（不确定）。使用
```
WITHIN GROUP (ORDER BY ...)
```
WITHIN GROUP (ORDER BY ...)
可以指定确定性的顺序。

使用示例

基本用法：返回第一个值

SELECT first_value(col), first(col) FROM VALUES (10), (5), (20) AS tab(col); +------------------+------------+ | first_value(col) | first(col) | +------------------+------------+ | 10 | 10 | +------------------+------------+

处理 NULL 值（默认返回第一个值，即使是 NULL）

忽略 NULL 值，返回第一个非 NULL 值

SELECT first_value(col, true), first(col, true) FROM VALUES (NULL), (5), (NULL) AS tab(col); +------------------------+-------------------+ | first_value(col, true) | first(col, true) | +------------------------+-------------------+ | 5 | 5 | +------------------------+-------------------+

使用 WITHIN GROUP (ORDER BY ...) 指定顺序

SELECT a, first_value(b) WITHIN GROUP(ORDER BY c) as first_b, first_value(b, true) WITHIN GROUP(ORDER BY c) as first_non_null_b FROM VALUES ('apple', 11, 22), ('apple', 1, 2), ('orange', NULL, 1), ('orange', 111, 2), ('orange', NULL, 3) AS t(a, b, c) GROUP BY a; +--------+---------+------------------+ | a | first_b | first_non_null_b | +--------+---------+------------------+ | apple | 1 | 1 | | orange | NULL | 111 | +--------+---------+------------------+

获取每个分组的第一个和最后一个值

SELECT category, first_value(value) as first_val, last_value(value) as last_val FROM VALUES ('A', 10), ('A', 20), ('B', 30), ('B', 40) AS t(category, value) GROUP BY category; +----------+-----------+----------+ | category | first_val | last_val | +----------+-----------+----------+ | A | 10 | 20 | | B | 30 | 40 | +----------+-----------+----------+

使用 FILTER 子句条件性地获取第一个值

SELECT first_value(col) FILTER (WHERE col > 5) FROM VALUES (3), (10), (7), (12) AS tab(col); +-------------------------------------------+ | first_value(col) FILTER (WHERE (col > 5)) | +-------------------------------------------+ | 10 | +-------------------------------------------+

联系我们