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

> Calcule le quantile d’un histogramme à l’aide d’une interpolation linéaire.

# quantilePrometheusHistogram

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

Introduit dans : v25.10.0

Calcule le [quantile](https://en.wikipedia.org/wiki/Quantile) d’un histogramme à l’aide d’une interpolation linéaire, en tenant compte de la valeur cumulative et des bornes supérieures de chaque bucket de l’histogramme.

Pour obtenir la valeur interpolée, toutes les valeurs transmises sont combinées dans un tableau, puis triées selon les bornes supérieures de leur bucket correspondant.
L’interpolation du quantile est ensuite effectuée de manière similaire à la fonction PromQL [histogram\_quantile()](https://prometheus.io/docs/prometheus/latest/querying/functions/#histogram_quantile) sur un histogramme classique, en réalisant une interpolation linéaire à partir des bornes inférieure et supérieure du bucket dans lequel se situe la position du quantile.

**Voir aussi**

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

**Syntaxe**

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

**Paramètres**

* `level` — Facultatif. Niveau du quantile. Nombre à virgule flottante constant compris entre 0 et 1. Nous recommandons d'utiliser une valeur de `level` dans l'intervalle `[0.01, 0.99]`. Valeur par défaut : `0.5`. Pour `level=0.5`, la fonction calcule la [médiane](https://en.wikipedia.org/wiki/Median). [`Float64`](/fr/reference/data-types/float)

**Arguments**

* `bucket_upper_bound` — Bornes supérieures des buckets de l'histogramme. Le bucket le plus élevé doit avoir une borne supérieure égale à `+Inf`. [`Float64`](/fr/reference/data-types/float)
* `cumulative_bucket_value` — Valeurs cumulées des buckets de l'histogramme. Les valeurs doivent être monotoniquement croissantes à mesure que la borne supérieure du bucket augmente. [`(U)Int*`](/fr/reference/data-types/int-uint) ou [`Float64`](/fr/reference/data-types/float)

**Valeur renvoyée**

Renvoie le quantile du niveau spécifié. [`Float64`](/fr/reference/data-types/float)

**Exemples**

**Exemple d'utilisation**

```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 │
└──────────────────────────────────────────────────────────────────────────┘
```

**Voir aussi**

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