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