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

Tablestore:GroupByHistogram

最終更新日:Dec 28, 2024

GroupByHistogram は、グループ化ヒストグラム機能を指定します。この機能を使用すると、特定のデータ間隔に基づいてクエリ結果をグループ化できます。同じ範囲内のフィールド値はグループ化されます。各グループの値の範囲と各グループの値の数が返されます。

リクエスト パラメーター

message GroupByHistogram {
    optional string field_name = 1;
    optional bytes interval = 2;
    optional bytes missing = 3;
    optional int64  min_doc_count = 4;
    optional GroupBySort sort = 5;
    optional FieldRange field_range = 6;
    optional Aggregations sub_aggs = 7;
    optional GroupBys sub_group_bys = 8;
}

パラメーター

タイプ

必須

説明

field_name

string

はい

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

interval

bytes

はい

統計間隔。値は PlainBuffer でエンコードする必要があります。詳細については、PlainBuffer を参照してください。

missing

bytes

いいえ

行のフィールド値が空の場合のフィールドのデフォルト値。値は PlainBuffer でエンコードする必要があります。詳細については、PlainBuffer を参照してください。

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

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

min_doc_count

int64

いいえ

行の最小数。グループ内の行数が行の最小数より少ない場合、グループの集計結果は返されません。

sort

GroupBySort

いいえ

グループ内の項目の並べ替えルール。デフォルトでは、グループ項目は降順に並べ替えられます。複数の並べ替えルールを設定した場合、データはルールが設定された順序に基づいて並べ替えられます。

field_range

FieldRange

はい

interval パラメーターと共に使用してグループ数を制限する範囲。(field_range.max-field_range.min)/interval の式を使用して計算された値は 2,000 を超えることはできません。

sub_aggs

Aggregations

いいえ

サブ集計操作。グループ化結果に対してサブ集計操作を実行できます。

sub_group_bys

GroupBys

いいえ

サブ GroupBy 操作。グループ化結果に対してサブ GroupBy 操作を実行できます。

レスポンス パラメーター

message GroupByHistogramResult {
    repeated GroupByHistogramItem group_by_histogra_items = 1;
}

パラメーター

タイプ

必須

説明

group_by_histogra_items

repeated GroupByHistogramItem

はい

返されたグループに関する情報。