> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-vortex-format.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> Calcula o `quantile_over_time` do PromQL em uma grade temporal regular.
# timeSeriesQuantileToGrid
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`](https://prometheus.io/docs/prometheus/latest/querying/functions/#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**
```sql theme={null}
timeSeriesQuantileToGrid(start_timestamp, end_timestamp, grid_step, staleness)(timestamp, value, phi)
timeSeriesQuantileToGrid(start_timestamp, end_timestamp, grid_step, staleness)(samples, phi)
```
**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`](/pt-BR/reference/data-types/int-uint) ou [`DateTime`](/pt-BR/reference/data-types/datetime) ou [`DateTime64`](/pt-BR/reference/data-types/datetime64) ou [`Float*`](/pt-BR/reference/data-types/float) ou [`Decimal*`](/pt-BR/reference/data-types/decimal) ou [`String`](/pt-BR/reference/data-types/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`](/pt-BR/reference/data-types/int-uint) ou [`DateTime`](/pt-BR/reference/data-types/datetime) ou [`DateTime64`](/pt-BR/reference/data-types/datetime64) ou [`Float*`](/pt-BR/reference/data-types/float) ou [`Decimal*`](/pt-BR/reference/data-types/decimal) ou [`String`](/pt-BR/reference/data-types/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`](/pt-BR/reference/data-types/int-uint) ou [`Float*`](/pt-BR/reference/data-types/float) ou [`Decimal*`](/pt-BR/reference/data-types/decimal) ou [`String`](/pt-BR/reference/data-types/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`](/pt-BR/reference/data-types/int-uint) ou [`Float*`](/pt-BR/reference/data-types/float) ou [`Decimal*`](/pt-BR/reference/data-types/decimal) ou [`String`](/pt-BR/reference/data-types/string)
**Argumentos**
* `timestamp` — Timestamp da amostra. Pode ser um valor individual ou um array. [`UInt32`](/pt-BR/reference/data-types/int-uint) ou [`DateTime`](/pt-BR/reference/data-types/datetime) ou [`DateTime64`](/pt-BR/reference/data-types/datetime64) ou [`Array(UInt32)`](/pt-BR/reference/data-types/array) ou [`Array(DateTime)`](/pt-BR/reference/data-types/array) ou [`Array(DateTime64)`](/pt-BR/reference/data-types/array)
* `value` — Valor da série temporal correspondente ao timestamp. Pode ser um valor individual ou um array. [`Float*`](/pt-BR/reference/data-types/float) ou [`Array(Float*)`](/pt-BR/reference/data-types/array)
* `samples` — Amostras da série temporal passadas como um array de tuplas `(timestamp, value)`, em que os elementos da tupla têm os tipos de timestamp e de valor listados acima. É uma alternativa a passar os timestamps e os valores como dois argumentos separados. [`Array(Tuple(T1, T2))`](/pt-BR/reference/data-types/array)
* `phi` — Nível do quantil, normalmente no intervalo \[0, 1]: pode ser um único número para toda a grade ou um array com um número por ponto da grade. Deve ser o mesmo em todas as linhas. [`Float*`](/pt-BR/reference/data-types/float) ou [`UInt8/16/32/64`](/pt-BR/reference/data-types/int-uint) ou [`Int8/16/32/64`](/pt-BR/reference/data-types/int-uint) ou [`Array(Float*)`](/pt-BR/reference/data-types/array) ou [`Array(UInt8/16/32/64)`](/pt-BR/reference/data-types/array) ou [`Array(Int8/16/32/64)`](/pt-BR/reference/data-types/array)
**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))`](/pt-BR/reference/data-types/array)
**Exemplos**