共用方式為


first 聚合函數

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

傳回資料列群組的 expr 的第一個值。 此函式與first_value聚合函數同義

語法

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

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

引數

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