共用方式為

first_value 聚合函數

  • 發行項

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

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

語法

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

您也可以使用 子句，將此函式叫用OVER為視窗函式。

引數

  • 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