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

> Calcule une quantile approximative d'une séquence de données numériques.

# quantile

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

Introduit dans : v1.1.0

Calcule un [`quantile`](https://en.wikipedia.org/wiki/Quantile) approximatif d’une séquence de données numériques.

Cette fonction utilise un [échantillonnage en réservoir](https://en.wikipedia.org/wiki/Reservoir_sampling), avec un réservoir d’une taille maximale de 8192 et un générateur de nombres aléatoires.
Le résultat est non déterministe.
Pour obtenir un quantile exact, utilisez la fonction [`quantileExact`](/fr/reference/functions/aggregate-functions/quantileExact#quantileExact).

Lors de l’utilisation de plusieurs fonctions `quantile*` à différents niveaux dans une requête, les états internes ne sont pas combinés (c’est-à-dire que la requête est moins efficace qu’elle pourrait l’être).
Dans ce cas, utilisez la fonction [`quantiles`](/fr/reference/functions/aggregate-functions/quantiles#quantiles).

Notez que, pour une séquence numérique vide, `quantile` renverra NaN, mais ses variantes `quantile*` renverront soit NaN, soit une valeur par défaut pour le type de séquence, selon la variante.

**Syntaxe**

```sql theme={null}
quantile(level)(expr)
```

**Alias** : `median`

**Paramètres**

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

**Arguments**

* `expr` — Expression sur les valeurs de la colonne, dont le résultat est de type numérique, Date ou DateTime. [`(U)Int*`](/fr/reference/data-types/int-uint) ou [`Float*`](/fr/reference/data-types/float) ou [`Decimal*`](/fr/reference/data-types/decimal) ou [`Date`](/fr/reference/data-types/date) ou [`DateTime`](/fr/reference/data-types/datetime)

**Valeur renvoyée**

Quantile approximatif pour le niveau spécifié. [`Float64`](/fr/reference/data-types/float) ou [`Date`](/fr/reference/data-types/date) ou [`DateTime`](/fr/reference/data-types/datetime)

**Exemples**

**Calcul du quantile**

```sql title=Query theme={null}
CREATE TABLE t (val UInt32) ENGINE = Memory;
INSERT INTO t VALUES (1), (1), (2), (3);

SELECT quantile(val) FROM t;
```

```response title=Response theme={null}
┌─quantile(val)─┐
│           1.5 │
└───────────────┘
```

**Voir aussi**

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