tencent cloud

Cloud Log Service

汎用集計関数

ダウンロード
フォーカスモード
フォントサイズ
最終更新日: 2026-10-12 14:32:16
AI翻訳
本文では、汎用集計関数の基本構文と例を紹介します。

関数説明

集計関数は、一連の値に対して計算を実行し、計算結果を返す関数です。CLSは以下の集計関数をサポートしています:
説明:
CLS分析ステートメントでは、文字列を表す文字は必ず一重引用符('')で囲む必要があります。記号で囲まれていない文字、または二重引用符("")で囲まれた文字は、フィールド名または列名を表します。例えば:'status'は文字列statusを表し、statusまたは"status"はログフィールドstatusを表します。
関数ステートメント
説明
例
arbitrary
(KEY)
目标列から非NULLの値をランダムに返します。
* | SELECT arbitrary(request_method) AS request_method
avg
(KEY)
目標列の算術平均値を計算します。
* | SELECT AVG(request_time)
bitwise_and_agg
(KEY)
目标列のすべての値のビット単位AND演算の結果を返します。
* | SELECT bitwise_and_agg(status)
bitwise_or_agg
(KEY)
目标列のすべての値のビット単位OR演算の結果を返します。
* | SELECT bitwise_or_agg(request_length)
checksum
(KEY)
目标列のチェックサム値を計算し、結果としてバイナリ文字列を返します。
* | SELECT checksum(request_method) AS request_method
count
(*)
すべての行数を表します。
* | SELECT COUNT(*) WHERE http_status >200
count
(1)
COUNT(1)はCOUNT(*)と同等であり、すべての行数を表します。
* | SELECT COUNT(1)
count
(KEY)
特定のKEY列において非NULLの行数を計算します。
* | SELECT COUNT(request_time) WHERE request_time >5.0
count_if
(boolean)
指定された条件を満たすログの件数を集計します。
* | select count_if(returnCode>=400) as errorCounts
geometric_mean
(KEY)
KEYの幾何平均を計算します。KEYに負数が含まれる場合は結果がNaNになります。
* | SELECT geometric_mean(request_time) AS request_time
max
(KEY)
KEY内の最大値をクエリします。
* | SELECT MAX(request_time) AS max_request_time
max_by
(x,y)
yが最大値の場合に対応するx値を返します。
* | SELECT MAX_BY(request_method, request_time) AS method
max_by
(x,y,n)
最大の n 個の y 値に対応する x 値を返し、戻り値は JSON 配列です。
* | SELECT max_by(request_method, request_time, 3) AS method
min
(KEY)
KEY内の最小値をクエリします。
* | SELECT MIN(request_time) AS min_request_time
min_by
(x,y)
yが最小値の場合に対応するx値を返します。
* | SELECT min_by(request_method, request_time) AS method
min_by
(x,y,n)
最小の n 個の y 値に対応する x 値を返します。戻り値は JSON 配列です。
* | SELECT min_by(request_method, request_time, 3) AS method
sum
(KEY)
KEYの合計値を計算します。
* | SELECT SUM(body_bytes_sent) AS sum_bytes
bool_and
(boolean)
すべてのログが指定された条件を満たすかどうかを判定し、満たす場合は TRUE を返し、それ以外の場合は FALSE を返します。
* | select bool_and(returnCode>=400)
bool_or
(boolean)
任意のログが指定された条件を満たすかどうかを判定し、満たす場合は TRUE を返し、それ以外の場合は FALSE を返します。
* | select bool_or(returnCode>=400)
every
(boolean)
bool_and(boolean)と同等です。
* | select every(returnCode>=400)
histogram(KEY)
各入力値の出現回数をカウントしたマップを返します。
* | SELECT histogram(http_code)
map_agg(KEY, VALUE)
入力された key / value ペアから作成されたマップを返します。
* | SELECT map_agg(host,http_code)
map_union(KEY)
すべての入力マップの和集合を返します。あるキーが複数の入力マップに出現する場合、結果マップにおけるそのキーの値は任意の1つの入力マップから取得されます。
* | SELECT map_union(m) FROM (VALUES (map(array['a','b'], array[1,2])), (map(array['b','c'], array[20,3]))) t(m)
multimap_agg(KEY, VALUE)
入力された key / value ペアから作成された多重マップを返します。各キーは複数の値に関連付けることができます。
* | SELECT multimap_agg(host,http_code)

パラメータ説明

パラメータ
説明
KEY
索引設定-キー値インデックスで統計を有効にしたログフィールド名、または複数の数値フィールドの四則演算結果やネストされたサブクエリのクエリ結果です。
x
パラメータ値は任意のデータ型です。
y
パラメータ値は任意のデータ型です。
n
0より大きい整数。


ヘルプとサポート

この記事はお役に立ちましたか?

フィードバック