適用於：
Databricks SQL Databricks Runtime
傳回資料列群組的 expr 的第一個值。 此函數是聚集函數的first同義詞。
語法
first_value(expr[, ignoreNull]) [FILTER ( WHERE cond ) ]
引數
-
expr：任何類型的表達式。 -
ignoreNull：預設為 false 的選擇性BOOLEAN常值。 -
cond：選擇性布爾表示式，篩選用於匯總的數據列。 -
IGNORE NULLS或RESPECT NULLS：使用 時IGNORE NULLS，或是ignoreNulltrue忽略 NULL 的任何expr值。 預設值為RESPECT NULLS。
傳回
結果的類型與 expr相同。
此函式不具決定性。
範例
> 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);
5
> SELECT first_value(col) FILTER (WHERE col > 5) FROM VALUES (5), (20) AS tab(col);
20