Todos os produtos
Search
Central de documentação

Tablestore:PercentilesAggregation

Última atualização: Jul 03, 2026

Define as estatísticas de percentil do recurso de agregação em índices de busca. Um valor de percentil indica a posição relativa de um valor em um conjunto de dados. Por exemplo, ao coletar estatísticas sobre o tempo de resposta de cada requisição durante a operação e manutenção rotineira do sistema, analise a distribuição desses tempos com percentis como p25, p50, p90 e p99.

Sintaxe da requisição

message PercentilesAggregation {
    optional string field_name = 1;
    repeated double percentiles = 2;
    optional bytes missing = 3;
}

Parâmetro

Tipo

Obrigatório

Descrição

field_name

string

Sim

Campo usado para agregação.

percentiles

double

Sim

Percentis desejados, como p50, p90 e p99. Especifique um ou mais valores separados por vírgula (,). Exemplo: 25,0,50,0,99,0.

O valor do percentil varia de 1 a 100.

missing

bytes

Não

Valor padrão assumido pelo campo quando este estiver vazio na linha. O valor desse parâmetro é codificado em PlainBuffer. Para mais informações, consulte PlainBuffer.

  • Se você não definir um valor para o parâmetro missing, a linha será ignorada.

  • Se você definir um valor para o parâmetro missing, esse valor será usado como o valor do campo na linha correspondente.

Sintaxe da resposta

message PercentilesAggregationResult {
    repeated PercentilesAggregationItem percentiles_aggregation_items = 1;
}

Parâmetro

Tipo

Obrigatório

Descrição

percentiles_aggregation_items

repeated PercentilesAggregationItem

Sim

Distribuição de percentis nas estatísticas calculadas.