Todos os produtos
Search
Central de documentação

Tablestore:GroupByHistogram

Última atualização: Jul 03, 2026

O GroupByHistogram define o recurso de agrupamento por histograma. Use esse recurso para agrupar resultados de consultas com base em intervalos de dados específicos. Valores de campo na mesma faixa pertencem ao mesmo grupo. O sistema retorna a faixa de valores e a quantidade de valores de cada grupo.

Parâmetros da solicitação

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

Parâmetro

Tipo

Obrigatório

Descrição

field_name

string

Sim

Campo usado para agregação.

interval

bytes

Sim

Intervalo estatístico. Codifique o valor em PlainBuffer. Para mais informações, consulte PlainBuffer.

missing

bytes

Não

Valor padrão do campo quando ele estiver vazio na linha. Codifique o valor em PlainBuffer. Para mais informações, consulte PlainBuffer.

  • Se você não especificar um valor para o parâmetro missing, o sistema ignorará a linha.

  • Se você especificar um valor para o parâmetro missing, o sistema usará esse valor como valor do campo na linha.

min_doc_count

int64

Não

Número mínimo de linhas. Se um grupo tiver menos linhas que esse mínimo, o sistema não retornará os resultados de agregação desse grupo.

sort

GroupBySort

Não

Regras de ordenação dos itens em um grupo. Por padrão, os itens do grupo são classificados em ordem decrescente. Se você configurar várias regras de ordenação, o sistema classificará os dados conforme a ordem de configuração das regras.

field_range

FieldRange

Sim

Faixa usada com o parâmetro interval para limitar o número de grupos. O valor calculado pela fórmula (field_range.max-field_range.min)/interval não pode exceder 2.000.

sub_aggs

Aggregations

Não

Operação de subagregação. Você pode executar a subagregação nos resultados do agrupamento.

sub_group_bys

GroupBys

Não

Operação de sub-GroupBy. Você pode executar a operação de sub-GroupBy nos resultados do agrupamento.

Parâmetros da resposta

message GroupByHistogramResult {
    repeated GroupByHistogramItem group_by_histogra_items = 1;
}

Parâmetro

Tipo

Obrigatório

Descrição

group_by_histogra_items

repeated GroupByHistogramItem

Sim

Informações sobre os grupos retornados.