first_value 集計関数

  • [アーティクル]

適用対象:「はい」のチェック マーク Databricks SQL 「はい」のチェック マーク Databricks Runtime

行グループの expr の最初の値を返します。 この関数は、first 集計関数のシノニムです。

構文

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

この関数は、OVER 句を使用して ウィンドウ 関数として呼び出すこともできます。

引数

  • expr: 任意の型の式。
  • ignoreNull: 省略可能なブール リテラル (既定では false )。
  • cond: 集計に使用される行をフィルター処理するブール式 (省略可能)。
  • IGNORE NULLS または RESPECT NULLS: IGNORE NULLS が使用されている場合、または ignoreNull が 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