sum()

式が返す数値の合計を計算します。

構文

sum(NUM_EXPR)

パラメーター

NUM_EXPR
合計を計算する数値を返す式。

説明

sum() 関数は、各レコードで NUM_EXPR を評価して数値の合計を累積します。整数(long)と実数(double)を区別して累積し、整数値のみの場合は64ビット整数を返し、実数値が含まれる場合は整数の合計結果と実数の合計結果を加算して返します。null 値や数値でない値は集計から除外されます。入力値がすべて null または数値でない場合は null を返します。

statstimechart などの集計コマンドで使用します。

エラーコード

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

使用例

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

  1. 全リクエストのレスポンスサイズの合計を計算

    table WEB_APACHE_SAMPLE | stats sum(bytes)
    
  2. HTTPメソッド別のレスポンスサイズの合計を計算

    table WEB_APACHE_SAMPLE | stats sum(bytes) by method
    
  3. NULL値の処理

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

互換性

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