日期直方图统计-表格存储 Tablestore(Tablestore)-阿里云帮助中心

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` 的值不能超过 2000。
missing	bytes	否	字段为空时使用的默认值，采用 PlainBuffer 编码，详见Plainbuffer编码。未设置时，字段为空的行不参与统计。设置后，以该值作为空字段的默认值参与统计。
min_doc_count	int64	否	分组最小行数。行数小于此值的分组不返回统计结果。
time_zone	string	否	时区偏移量，格式为 `+hh:mm` 或 `-hh:mm`，例如 `+08:00`、`-09:00`。
sort	GroupBySort	否	分组内 item 的排序规则，默认按 item 数量降序排列。指定多个排序规则时，按添加顺序依次生效。
sub_aggs	Aggregations	否	子聚合（Aggregation），对每个分组的结果再次进行聚合分析。
sub_group_bys	GroupBys	否	子分组（GroupBy），对每个分组的结果再次进行分组分析。

响应数据结构

message GroupByDateHistogramResult {
    repeated GroupByDateHistogramItem group_by_date_histogram_items = 1;
}

名称	类型	是否必选	描述
group_by_date_histogram_items	repeated GroupByDateHistogramItem	是	返回的分组信息列表。