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

Tablestore:GroupByDateHistogram

最終更新日:Dec 28, 2024

GroupByDateHistogram は、特定のデータ間隔に基づいてクエリ結果をグループ化します。同じ範囲内のフィールド値はグループ化されます。各グループの値の範囲と各グループの値の数が返されます。

リクエストパラメーター

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

パラメーター

タイプ

必須

説明

field_name

string

はい

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

interval

DateTimeValue

はい

間隔の設定。

field_range

FieldRange

はい

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

missing

bytes

いいえ

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

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

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

min_doc_count

int64

いいえ

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

time_zone

string

いいえ

+hh:mm または -hh:mm 形式のタイムゾーン(+08:00-09:00 など)。

sort

GroupBySort

いいえ

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

sub_aggs

Aggregations

いいえ

グループ化結果に基づいて実行されるサブ集計操作。

sub_group_bys

GroupBys

いいえ

グループ化結果に基づいて実行されるサブ GroupBy 操作。

レスポンスパラメーター

message GroupByDateHistogramResult {
    repeated GroupByDateHistogramItem group_by_date_histogram_items = 1;
}

パラメーター

タイプ

必須

説明

group_by_date_histogram_items

repeated GroupByDateHistogramItem

はい

返されたグループ。