> ## 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 un quantile approximatif d'une séquence de données numériques à l'aide de l'algorithme t-digest.

# quantileTDigest

<div id="quantileTDigest">
  ## quantileTDigest
</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 à l’aide de l’algorithme [t-digest](https://github.com/tdunning/t-digest/blob/master/docs/t-digest-paper/histo.pdf).

La consommation de mémoire est de `log(n)`, où `n` représente un nombre de valeurs. Le résultat dépend de l’ordre d’exécution de la requête et n’est pas déterministe.

Les performances de cette fonction sont inférieures à celles de [`quantile`](/fr/reference/functions/aggregate-functions/quantile) ou de [`quantileTiming`](/fr/reference/functions/aggregate-functions/quantileTiming). En termes de rapport entre la taille de l’état et la précision, cette fonction est bien meilleure que `quantile`.

Lorsqu’on utilise plusieurs fonctions `quantile*` avec différents niveaux dans une requête, les états internes ne sont pas combinés (autrement dit, la requête s’exécute moins efficacement qu’elle ne le pourrait). Dans ce cas, utilisez la fonction [`quantiles`](/fr/reference/functions/aggregate-functions/quantiles#quantiles).

**Syntaxe**

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

**Alias** : `medianTDigest`

**Paramètres**

* `level` — Facultatif. Niveau du quantile. Nombre constant à virgule flottante compris entre 0 et 1. Nous recommandons d'utiliser une valeur de `level` comprise 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 appliquée aux valeurs de la colonne, produisant des types de données numériques, 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 de retour**

Quantile approximatif du niveau indiqué. [`Float64`](/fr/reference/data-types/float) ou [`Date`](/fr/reference/data-types/date) ou [`DateTime`](/fr/reference/data-types/datetime)

**Exemples**

**Calcul d'un quantile avec t-digest**

```sql title=Query theme={null}
SELECT quantileTDigest(number) FROM numbers(10);
```

```response title=Response theme={null}
┌─quantileTDigest(number)─┐
│                     4.5 │
└─────────────────────────┘
```

**Voir aussi**

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