first()

グループ内で最初に現れた null でない値を返します。

構文

first(EXPR)

パラメーター

EXPR
最初の値を抽出するフィールドを返す式。

説明

first() 関数は、グループ内のレコードを順番に処理しながら、EXPR が返す値のうち null でない最初の値を記録します。最初の有効な値が記録された後は、以降のレコードを無視します。null 値はスキップします。

集計が完了すると、記録された最初の値をそのまま返します。返り値の型は EXPR の型に従います。グループ内に有効な値がない場合は null を返します。

stats、timechart などの集計コマンドでのみ使用できます。

エラーコード

コード説明
91020引数の数が正しくありません。

使用例

これらの使用例で参照する WEB_APACHE_SAMPLE テーブルを準備するには、クエリ実習用データを参照してください。

  1. 各送信元 IP の最初のリクエスト URI を抽出

    table WEB_APACHE_SAMPLE | stats first(uri) by src_ip

  2. HTTP メソッドごとの最初のリクエストのレスポンスサイズを抽出

    table WEB_APACHE_SAMPLE | stats first(bytes) by method

  3. null 値の処理

    json "[{'val': null}, {'val': null}, {'val': 30}]"
| stats first(val)
| # first(val): 30

互換性

first() 関数は Logpresso Sonar 4.0以前のバージョンから提供されています。