Skip to main content

​
timeSeriesQuantileToGrid

Introduzido em: v26.9.0 Função de agregação que recebe dados de séries temporais como pares de timestamps e valores e calcula a função PromQL quantile_over_time em uma grade temporal regular definida por timestamp inicial, timestamp final e passo. Para cada ponto da grade, as amostras usadas no cálculo do quantil são consideradas dentro da janela de tempo especificada. O quantil é calculado pelo método R-7 (inclusivo), assim como em quantileExactInclusive. Diferentemente de quantileExactInclusive, as amostras NaN não são ignoradas: assim como no Prometheus, elas são mantidas e ordenadas antes de qualquer valor real. Desse modo, uma janela [1, NaN, 2] tem mediana 1, e uma janela em que todas as amostras são NaN resulta em NaN. O nível do quantil é passado após as amostras, como último argumento: pode ser um único número, usado em todos os pontos da grade, ou um array com um número por ponto da grade. Ele deve ser o mesmo em todas as linhas. Assim como no Prometheus, um nível abaixo de 0 resulta em -Inf, um nível acima de 1 resulta em +Inf, e um nível NaN resulta em NaN para todo ponto da grade cuja janela contenha amostras.
Esta função está em prévia privada; habilite-a definindo enable_time_series_aggregate_functions=true.
Sintaxe
Parâmetros
  • start_timestamp — Especifica o início da grade. Também pode ser um número fracionário ou uma string contendo um número ou um texto de data e hora. UInt32 ou DateTime ou DateTime64 ou Float* ou Decimal* ou String
  • end_timestamp — Especifica o fim da grade. Também pode ser um número fracionário ou uma string contendo um número ou um texto de data e hora. UInt32 ou DateTime ou DateTime64 ou Float* ou Decimal* ou String
  • grid_step — Especifica o passo da grade, em segundos. Também pode ser um número fracionário ou uma string contendo um número ou uma duração, como ’15s’ ou ‘1m’. UInt32 ou Float* ou Decimal* ou String
  • staleness — Especifica a “staleness” máxima, em segundos, das amostras consideradas. A janela de staleness é um intervalo aberto à esquerda e fechado à direita. Também pode ser um número fracionário ou uma string contendo um número ou uma duração, como ’15s’ ou ‘1m’. UInt32 ou Float* ou Decimal* ou String
Argumentos Valor retornado Retorna o quantil phi dos valores na grade especificada. O array retornado contém um valor para cada ponto da grade temporal. O valor é NULL quando não há amostras dentro da janela de um determinado ponto da grade. Array(Nullable(Float64)) Exemplos
Última modificação em 14 de outubro de 2026