All Products
Search
Document Center

Tablestore:GroupByDateHistogram

Last Updated:Apr 30, 2026

GroupByDateHistogram mengelompokkan hasil kueri ke dalam interval berbasis tanggal. Baris yang nilai bidangnya berada dalam interval yang sama ditempatkan dalam satu kelompok. Setiap kelompok mengembalikan rentang nilainya serta jumlah baris yang sesuai.

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

Type

Wajib

Deskripsi

field_name

string

Ya

Bidang yang akan diajukan agregasi.

interval

DateTimeValue

Ya

Konfigurasi interval.

field_range

FieldRange

Ya

Rentang nilai yang digunakan bersama dengan interval untuk membatasi jumlah kelompok. Nilai dari (field_range.max-field_range.min)/interval tidak boleh melebihi 2.000.

missing

bytes

Tidak

Nilai default untuk baris yang bidangnya kosong. Nilai tersebut harus dikodekan dalam format PlainBuffer. Untuk informasi lebih lanjut, lihat PlainBuffer.

  • Jika tidak diatur, baris dengan bidang kosong dikecualikan dari hasil.

  • Jika diatur, nilai yang ditentukan digunakan sebagai nilai bidang untuk baris tersebut.

min_doc_count

int64

Tidak

Jumlah minimum baris yang harus dimiliki suatu kelompok agar dimasukkan dalam hasil. Kelompok dengan jumlah baris lebih sedikit dikecualikan.

time_zone

string

Tidak

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

sort

GroupBySort

Tidak

Aturan pengurutan untuk kelompok. Kelompok diurutkan secara descending secara default. Saat beberapa aturan ditentukan, aturan tersebut diterapkan sesuai urutan yang tercantum.

sub_aggs

Aggregations

Tidak

Sub-agregasi yang dijalankan pada hasil setiap kelompok.

sub_group_bys

GroupBys

Tidak

Operasi Sub-GroupBy yang dijalankan pada hasil setiap kelompok.

Parameter respons

message GroupByDateHistogramResult {
    repeated GroupByDateHistogramItem group_by_date_histogram_items = 1;
}

Parameter

Type

Wajib

Deskripsi

group_by_date_histogram_items

repeated GroupByDateHistogramItem

Ya

Kelompok yang dikembalikan.