全部产品
Search
文档中心

Tablestore:GroupByDateHistogram

更新时间:Jul 02, 2025

GroupByDateHistogram mengelompokkan hasil kueri berdasarkan interval data tertentu. Nilai bidang dalam rentang yang sama dikelompokkan bersama. Rentang nilai setiap kelompok dan jumlah nilai di dalamnya dikembalikan.

Parameter permintaan

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;
}

Parameter

Tipe

Diperlukan

Deskripsi

field_name

string

Ya

Bidang yang digunakan untuk agregasi.

interval

DateTimeValue

Ya

Konfigurasi interval.

field_range

FieldRange

Ya

Rentang yang digunakan bersama dengan parameter interval untuk membatasi jumlah kelompok. Nilai yang dihitung menggunakan rumus (field_range.max-field_range.min)/interval tidak boleh melebihi 2.000.

missing

bytes

Tidak

Nilai default suatu bidang jika nilai bidang tersebut kosong dalam baris. Nilai parameter ini dikodekan dalam PlainBuffer. Untuk informasi lebih lanjut, lihat PlainBuffer.

  • Jika Anda tidak menentukan nilai untuk parameter missing, baris akan diabaikan.

  • Jika Anda menentukan nilai untuk parameter missing, nilai parameter ini digunakan sebagai nilai bidang dari baris.

min_doc_count

int64

Tidak

Jumlah minimum baris. Jika jumlah baris dalam kelompok kurang dari jumlah minimum baris, hasil agregasi untuk kelompok tersebut tidak dikembalikan.

time_zone

string

Tidak

Zona waktu dalam format +hh:mm atau -hh:mm, seperti +08:00 atau -09:00.

sort

GroupBySort

Tidak

Aturan pengurutan untuk item dalam kelompok. Secara default, item diurutkan secara menurun. Jika Anda mengonfigurasi beberapa aturan pengurutan, data diurutkan berdasarkan urutan konfigurasi aturan tersebut.

sub_aggs

Aggregations

Tidak

Operasi sub-agregasi yang dilakukan berdasarkan hasil pengelompokan.

sub_group_bys

GroupBys

Tidak

Operasi sub-GroupBy yang dilakukan berdasarkan hasil pengelompokan.

Parameter respons

message GroupByDateHistogramResult {
    repeated GroupByDateHistogramItem group_by_date_histogram_items = 1;
}

Parameter

Tipe

Diperlukan

Deskripsi

group_by_date_histogram_items

repeated GroupByDateHistogramItem

Ya

Kelompok yang dikembalikan.