共用方式為


first 聚合函數

適用於:核取記號為「是」Databricks SQL 核取記號為「是」Databricks Runtime

傳回一組資料列中的 expr 的第一個值。 此函數是聚集函數的first_value同義詞。

語法

first(expr[, ignoreNull]) [FILTER ( WHERE cond ) ]

您也可以使用 子句將此函式叫用為 OVER

引數

  • expr:任何類型的表達式。
  • ignoreNull:預設為 false 的選擇性 BOOLEAN 文字常量。
  • cond:選擇性布爾表示式,篩選用於匯總的數據列。
  • IGNORE NULLSRESPECT NULLS:當使用IGNORE NULLSignoreNulltrue時,任何為 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