全部產品
Search
文件中心

Tablestore:GroupByDateHistogram

更新時間:Jun 30, 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

返回的分組資訊。