Skip to main content

​
timeSeriesQuantileToGrid

Introducido en: v26.9.0 Función de agregación que recibe datos de series temporales como pares de marcas de tiempo y valores, y calcula la función PromQL quantile_over_time sobre una cuadrícula temporal regular definida por una marca de tiempo de inicio, una marca de tiempo de fin y un paso. Para cada punto de la cuadrícula, las muestras que se usan para calcular el cuantil son las que se encuentran dentro de la ventana de tiempo especificada. El cuantil se calcula mediante el método R-7 (inclusivo), igual que quantileExactInclusive. A diferencia de quantileExactInclusive, las muestras NaN no se omiten: al igual que en Prometheus, se conservan y se ordenan antes de cualquier valor real, de modo que una ventana [1, NaN, 2] tiene mediana 1, y una ventana cuyas muestras son todas NaN devuelve NaN. El nivel del cuantil se pasa después de las muestras, como último argumento: puede ser un único número que se aplica a todos los puntos de la cuadrícula o un array con un número por cada punto de la cuadrícula. Debe ser el mismo en todas las filas. Al igual que en Prometheus, un nivel inferior a 0 devuelve -Inf, un nivel superior a 1 devuelve +Inf y un nivel NaN devuelve NaN en todos los puntos de la cuadrícula cuya ventana contenga muestras.
Esta función está en vista previa privada; para habilitarla, configure enable_time_series_aggregate_functions=true.
Sintaxis
Parámetros
  • start_timestamp — Especifica el inicio de la cuadrícula. También puede ser un número fraccionario o una cadena que contenga un número o un texto de fecha y hora. UInt32 o DateTime o DateTime64 o Float* o Decimal* o String
  • end_timestamp — Especifica el final de la cuadrícula. También puede ser un número fraccionario o una cadena que contenga un número o un texto de fecha y hora. UInt32 o DateTime o DateTime64 o Float* o Decimal* o String
  • grid_step — Especifica el paso de la cuadrícula en segundos. También puede ser un número fraccionario o una cadena que contenga un número o una duración, como ’15s’ o ‘1m’. UInt32 o Float* o Decimal* o String
  • staleness — Especifica la “antigüedad” máxima, en segundos, de las muestras consideradas. La ventana de antigüedad es un intervalo abierto por la izquierda y cerrado por la derecha. También puede ser un número fraccionario o una cadena que contenga un número o una duración, como ’15s’ o ‘1m’. UInt32 o Float* o Decimal* o String
Argumentos Valor devuelto Devuelve el cuantil phi de los valores en la cuadrícula especificada. El array devuelto contiene un valor por cada punto de la cuadrícula temporal. El valor es NULL si no hay muestras dentro de la ventana para un punto determinado de la cuadrícula. Array(Nullable(Float64)) Ejemplos
Última modificación el 14 de octubre de 2026