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

Tablestore:GroupByDateHistogram

最終更新日:Apr 30, 2026

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」をご参照ください。

  • 設定されていない場合、フィールドが空の行は結果から除外されます。

  • 設定されている場合、指定された値がそれらの行のフィールド値として使用されます。

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

はい

返されるグループです。