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

# quantileTDigestWeighted

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

Introduit dans : v20.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 fonction prend en compte le poids de chaque élément de la séquence.

L’erreur maximale est de 1 %.
L’utilisation mémoire est de `log(n)`, où `n` est le nombre de valeurs.

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`.

Le résultat dépend de l’ordre d’exécution de la requête et est non déterministe.

Lors de l’utilisation de plusieurs fonctions `quantile*` avec 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).

<Note>
  L’utilisation de `quantileTDigestWeighted` [n’est pas recommandée pour les petits jeux de données](https://github.com/tdunning/t-digest/issues/167#issuecomment-828650275) et peut entraîner une erreur importante.
  Dans ce cas, envisagez plutôt d’utiliser [`quantileTDigest`](/fr/reference/functions/aggregate-functions/quantileTDigest).
</Note>

**Syntaxe**

```sql theme={null}
quantileTDigestWeighted(level)(expr, weight)
```

**Alias** : `medianTDigestWeighted`

**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 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)
* `weight` — Colonne contenant les poids des éléments de la séquence. Le poids correspond au nombre d'occurrences d'une valeur. [`UInt*`](/fr/reference/data-types/int-uint)

**Valeur renvoyée**

Quantile approximatif du 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 d'un quantile pondéré avec t-digest**

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

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

**Voir aussi**

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