Todos os produtos
Search
Central de documentação

Tablestore:GroupByDateHistogram

Última atualização: Jul 03, 2026

O GroupByDateHistogram agrupa os resultados da consulta em intervalos baseados em data. Linhas com valores de campo no mesmo intervalo pertencem ao mesmo grupo. Cada grupo retorna sua faixa de valores e a quantidade de linhas correspondentes.

Parâmetros da solicitação

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

Parâmetro

Tipo

Obrigatório

Descrição

field_name

string

Sim

Campo usado para agregação.

interval

DateTimeValue

Sim

Configuração do intervalo.

field_range

FieldRange

Sim

Faixa de valores usada com interval para limitar o número de grupos. O valor de (field_range.max-field_range.min)/interval não pode exceder 2.000.

missing

bytes

Não

Valor padrão para linhas com campo vazio. Codifique o valor no formato PlainBuffer. Para mais informações, consulte PlainBuffer.

  • Se não defina, linhas com campo vazio são excluídas dos resultados.

  • Se defina, o valor especificado substitui o campo nessas linhas.

min_doc_count

int64

Não

Quantidade mínima de linhas necessárias para incluir um grupo nos resultados. Grupos abaixo desse limite são excluídos.

time_zone

string

Não

Deslocamento de fuso horário no formato +hh:mm ou -hh:mm, como +08:00 ou -09:00.

sort

GroupBySort

Não

Regras de ordenação dos grupos. A ordem decrescente é o padrão. Múltiplas regras seguem a sequência listada.

sub_aggs

Aggregations

Não

Subagregações aplicadas aos resultados de cada grupo.

sub_group_bys

GroupBys

Não

Operações de sub-GroupBy aplicadas aos resultados de cada grupo.

Parâmetros de resposta

message GroupByDateHistogramResult {
    repeated GroupByDateHistogramItem group_by_date_histogram_items = 1;
}

Parâmetro

Tipo

Obrigatório

Descrição

group_by_date_histogram_items

repeated GroupByDateHistogramItem

Sim

Grupos retornados.