> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8a08bda2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Calcula o quantil de um histograma por interpolação linear.

# quantilePrometheusHistogram

<div id="quantilePrometheusHistogram">
  ## quantilePrometheusHistogram
</div>

Introduzido em: v25.10.0

Calcula o [quantil](https://en.wikipedia.org/wiki/Quantile) de um histograma usando interpolação linear, levando em conta o valor cumulativo e os limites superiores de cada bucket do histograma.

Para obter o valor interpolado, todos os valores fornecidos são combinados em um array, que é então ordenado de acordo com os valores correspondentes de limite superior do bucket.
A interpolação do quantil é então realizada de forma semelhante à função PromQL [histogram\_quantile()](https://prometheus.io/docs/prometheus/latest/querying/functions/#histogram_quantile) em um histograma clássico, executando uma interpolação linear com base nos limites inferior e superior do bucket em que a posição do quantil é encontrada.

**Veja também**

* [median](/pt-BR/reference/functions/aggregate-functions/median)
* [quantiles](/pt-BR/reference/functions/aggregate-functions/quantiles)

**Sintaxe**

```sql theme={null}
quantilePrometheusHistogram(level)(bucket_upper_bound, cumulative_bucket_value)
```

**Parâmetros**

* `level` — Opcional. Nível do quantil. Número de ponto flutuante constante entre 0 e 1. Recomendamos usar um valor de `level` no intervalo `[0.01, 0.99]`. Valor padrão: `0.5`. Em `level=0.5`, a função calcula a [mediana](https://en.wikipedia.org/wiki/Median). [`Float64`](/pt-BR/reference/data-types/float)

**Argumentos**

* `bucket_upper_bound` — Limites superiores dos buckets do histograma. O bucket mais alto deve ter um limite superior de `+Inf`. [`Float64`](/pt-BR/reference/data-types/float)
* `cumulative_bucket_value` — Valores cumulativos dos buckets do histograma. Os valores devem aumentar monotonicamente à medida que o limite superior do bucket aumenta. [`(U)Int*`](/pt-BR/reference/data-types/int-uint) ou [`Float64`](/pt-BR/reference/data-types/float)

**Valor retornado**

Retorna o quantil do nível especificado. [`Float64`](/pt-BR/reference/data-types/float)

**Exemplos**

**Exemplo de uso**

```sql title=Query theme={null}
SELECT quantilePrometheusHistogram(bucket_upper_bound, cumulative_bucket_value)
FROM VALUES('bucket_upper_bound Float64, cumulative_bucket_value UInt64', (0, 6), (0.5, 11), (1, 14), (inf, 19));
```

```response title=Response theme={null}
┌─quantilePrometheusHistogram(bucket_upper_bound, cumulative_bucket_value)─┐
│                                                                     0.35 │
└──────────────────────────────────────────────────────────────────────────┘
```

**Veja também**

* [median](/pt-BR/reference/functions/aggregate-functions/median)
* [quantiles](/pt-BR/reference/functions/aggregate-functions/quantiles)