> ## 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 le quantile d’une séquence de données numériques par interpolation linéaire, en tenant compte du poids de chaque élément.

# quantileInterpolatedWeighted

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

Introduit dans : v23.1.0

Calcule le [quantile](https://en.wikipedia.org/wiki/Quantile) d’une séquence de données numériques par interpolation linéaire, en tenant compte du poids de chaque élément.

Pour obtenir la valeur interpolée, toutes les valeurs transmises sont regroupées dans un tableau, puis triées selon les poids correspondants.
L’interpolation des quantiles est ensuite effectuée à l’aide de la [méthode du percentile pondéré](https://en.wikipedia.org/wiki/Percentile#The_weighted_percentile_method), en construisant une distribution cumulative à partir des poids, puis en réalisant une interpolation linéaire à partir des poids et des valeurs pour calculer les quantiles.

Lorsque plusieurs fonctions `quantile*` avec des niveaux différents sont utilisées 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).

**Syntaxe**

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

**Alias** : `medianInterpolatedWeighted`

**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. Pour `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, 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)
* `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 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é interpolé**

```sql title=Query theme={null}
CREATE TABLE t (
    n Int32,
    val Int32
) ENGINE = Memory;

INSERT INTO t VALUES (0, 3), (1, 2), (2, 1), (5, 4);

SELECT quantileInterpolatedWeighted(n, val) FROM t;
```

```response title=Response theme={null}
┌─quantileInterpolatedWeighted(n, val)─┐
│                                    1 │
└──────────────────────────────────────┘
```

**Voir aussi**

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