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