first_value 彙總函式

適用于:核取標示為是 Databricks SQL 檢查標示為是 Databricks Runtime

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

語法

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

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

參數

  • expr:任何類型的運算式。
  • ignoreNull:選擇性的 BOOLEAN 常值預設為 false。
  • cond:選擇性布林運算式,篩選用於匯總的資料列。
  • IGNORE NULLSRESPECT NULLS :使用 ignoreNullIGNORE NULLS 時會 true 忽略 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