全部产品
Search
文档中心

Tablestore:GroupByHistogram

更新时间:Jul 02, 2025

GroupByHistogram mendefinisikan fitur pengelompokan berdasarkan histogram. Fitur ini memungkinkan pengelompokan hasil kueri berdasarkan interval data tertentu. Nilai bidang dalam rentang yang sama dikelompokkan bersama, dengan mengembalikan rentang nilai setiap kelompok serta jumlah nilai di dalamnya.

Parameter permintaan

message GroupByHistogram {
    optional string field_name = 1;
    optional bytes interval = 2;
    optional bytes missing = 3;
    optional int64  min_doc_count = 4;
    optional GroupBySort sort = 5;
    optional FieldRange field_range = 6;
    optional Aggregations sub_aggs = 7;
    optional GroupBys sub_group_bys = 8;
}

Parameter

Tipe

Diperlukan

Deskripsi

field_name

string

Ya

Bidang yang digunakan untuk agregasi.

interval

bytes

Ya

Interval statistik. Nilainya harus dienkripsi dalam PlainBuffer. Untuk informasi lebih lanjut, lihat PlainBuffer.

missing

bytes

Tidak

Nilai default suatu bidang jika nilai bidang tersebut kosong dalam baris. Nilainya harus dienkripsi 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 sebuah grup kurang dari jumlah minimum baris, hasil agregasi untuk grup tersebut tidak dikembalikan.

sort

GroupBySort

Tidak

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

field_range

FieldRange

Ya

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

sub_aggs

Aggregations

Tidak

Operasi sub-agregasi. Anda dapat melakukan operasi sub-agregasi pada hasil pengelompokan.

sub_group_bys

GroupBys

Tidak

Operasi sub-GroupBy. Anda dapat melakukan operasi sub-GroupBy pada hasil pengelompokan.

Parameter respons

message GroupByHistogramResult {
    repeated GroupByHistogramItem group_by_histogra_items = 1;
}

Parameter

Tipe

Diperlukan

Deskripsi

group_by_histogra_items

repeated GroupByHistogramItem

Ya

Informasi tentang grup yang dikembalikan.