Todos os produtos
Search
Central de documentação

Tablestore:GroupByRange

Última atualização: Jul 03, 2026

O GroupByRange agrupa resultados de pesquisa em buckets com base em intervalos numéricos. Cada bucket abrange um intervalo fechado à esquerda e aberto à direita e retorna o número de linhas correspondentes nesse intervalo.

Parâmetros da solicitação

message GroupByRange {
    optional string field_name = 1;
    repeated Range ranges = 2;
    optional Aggregations sub_aggs = 3;
    optional GroupBys sub_group_bys = 4;
}

Parâmetro

Tipo

Obrigatório

Descrição

field_name

string

Sim

Campo numérico para agrupamento.

ranges

repeated Range

Sim

Intervalos que definem os buckets. Cada intervalo é fechado à esquerda e aberto à direita: [from, to).

sub_aggs

Aggregations

Não

Subagregação executada em cada bucket.

sub_group_bys

GroupBys

Não

Sub-GroupBy executado em cada bucket.

Parâmetros da resposta

message GroupByRangeResult {
    repeated GroupByRangeResultItem group_by_range_result_items = 1;
}

Parâmetro

Tipo

Obrigatório

Descrição

group_by_range_result_items

repeated GroupByRangeResultItem

Sim

Lista de buckets retornados, com um item por intervalo.