全部产品
Search
文档中心

表格存储:GroupByDateHistogram

更新时间:Apr 09, 2024

在多元索引统计聚合中表示日期直方图统计,用于对日期字段类型的数据按照指定间隔对查询结果进行分组,字段值在相同范围内放到同一分组内,返回每个分组的值和该值对应的个数。

请求数据结构

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编码。

  • 如果未设置missing值,则在统计聚合时会忽略该行。

  • 如果设置了missing值,则使用missing值作为字段值的默认值参与统计聚合。

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

返回的分组信息。