first
聚合函數
適用於:Databricks SQL Databricks Runtime
傳回資料列群組的 expr
的第一個值。 此函式與first_value聚合函數同義。
語法
first(expr[, ignoreNull]) [FILTER ( WHERE cond ) ]
您也可以使用 OVER
子句,將此函式叫用為 window 函式。
引數
-
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