FIRST
フィールドまたはグループ内で見つかった最初の値を返します。オプションとして、読み込む行を制限するフィルタを適用できます。FIRSTの中にネストできる他の集計関数は1つだけです。
マッピングタスクでのみ使用します。
構文
FIRST( value [, filter_condition ] )
引数 | 必須/ オプション | 説明 |
|---|
value | 必須 | Binary以外の任意のデータ型。最初の値を返したい値を渡します。有効なトランスフォーメーション式を必要に応じて入力できます。 |
filter_condition | オプション | 検索される行を制限します。フィルタ条件は数値であるか、TRUE、FALSE、またはNULLの値が求められなければなりません。有効なトランスフォーメーション式を必要に応じて入力できます。 |
戻り値
グループの最初の値。
関数に渡された値がすべてNULLである場合、または行が1つも選択されていない場合（たとえば、フィルタ条件の値がすべての行に対してFALSEまたはNULLであった場合）には、NULLです。
NULL
値がNULLであると、FIRSTはその行を無視します。ただし、フィールドから渡された値がすべてNULLである場合には、NULLを返します。
Group By
FIRSTは、トランスフォーメーションで定義したグループ化フィールドに基づいて値をグループ分けし、各グループについて1つの結果を返します。
グループ化フィールドがない場合には、FIRSTはすべての行を1つのグループとして扱い、1つの値を返します。
例
次の式は、ITEM_NAMEフィールド内で価格が$10.00を超える最初の値を返します。
FIRST( ITEM_NAME, ITEM_PRICE > 10 )
ITEM_NAME | ITEM_PRICE |
|---|
Flashlight | 35.00 |
Navigation Compass | 8.05 |
Regulator System | 150.00 |
Flashlight | 29.00 |
Depth/Pressure Gauge | 88.00 |
Flashlight | 31.00 |
RETURN VALUE: Flashlight | |
次の式は、ITEM_NAMEフィールド内で価格が$40.00を超える最初の値を返します。
FIRST( ITEM_NAME, ITEM_PRICE > 40 )
ITEM_NAME | ITEM_PRICE |
|---|
Flashlight | 35.00 |
Navigation Compass | 8.05 |
Regulator System | 150.00 |
Flashlight | 29.00 |
Depth/Pressure Gauge | 88.00 |
Flashlight | 31.00 |
RETURN VALUE: Regulator System | |