GroupByDateHistogram

更新時間:
Copy as MD

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

返回的分組資訊列表。