すべてのプロダクト
Search
ドキュメントセンター

Tablestore:PercentilesAggregation

最終更新日:Dec 28, 2024

検索インデックスの集計機能のパーセンタイル統計を指定します。パーセンタイル値は、データセット内の値の相対位置を示します。たとえば、システムの日常的なO&M中に各リクエストの応答時間の統計を収集する場合、p25、p50、p90、p99などのパーセンタイルを使用して応答時間の分布を分析する必要があります。

リクエスト構文

message PercentilesAggregation {
    optional string field_name = 1; // 集計に使用するフィールド。
    repeated double percentiles = 2; // p50、p90、p99などのパーセンタイル。1つ以上のパーセンタイルを指定できます。複数のパーセンタイルはカンマ(,)で区切ります。例:25.0,50.0,99.0。
    optional bytes missing = 3; // 行のフィールド値が空の場合のフィールドのデフォルト値。パラメータの値はPlainBufferでエンコードされます。詳細は、PlainBufferを参照してください。
}

パラメーター

タイプ

必須

説明

field_name

string

はい

集計に使用するフィールド。

percentiles

double

はい

p50、p90、p99などのパーセンタイル。1つ以上のパーセンタイルを指定できます。複数のパーセンタイルはカンマ(,)で区切ります。例:25.0,50.0,99.0

パーセンタイルの範囲は1~100です。

missing

bytes

いいえ

行のフィールド値が空の場合のフィールドのデフォルト値。パラメータの値はPlainBufferでエンコードされます。詳細については、PlainBufferを参照してください。

  • missingパラメータの値を指定しない場合、行は無視されます。

  • missingパラメータの値を指定した場合、パラメータの値が行のフィールド値として使用されます。

レスポンス構文

message PercentilesAggregationResult {
    repeated PercentilesAggregationItem percentiles_aggregation_items = 1; // パーセンタイル統計におけるパーセンタイル分布。
}

パラメーター

タイプ

必須

説明

percentiles_aggregation_items

repeated PercentilesAggregationItem

はい

パーセンタイル統計におけるパーセンタイル分布。