> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> La fonction `gini` calcule le coefficient de Gini d’une colonne numérique finie et non négative, une mesure des inégalités dans une distribution.

# gini

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

Introduite dans : v26.8.0

Calcule le [coefficient de Gini](https://en.wikipedia.org/wiki/Gini_coefficient) d’une colonne de valeurs numériques finies et non négatives, qui mesure les inégalités au sein d’une distribution.

Le résultat est compris entre `0` (égalité parfaite : toutes les valeurs sont identiques) et un maximum qui tend vers `1` à mesure que `n` augmente (inégalité parfaite : une valeur détient tout et les autres sont nulles). Pour un échantillon fini de `n` valeurs, le maximum est `(n - 1) / n`.

Toutes les valeurs fournies sont collectées dans leur type d’entrée, puis triées avant le calcul final numériquement stable. Le coefficient est calculé à partir de différences normalisées entre paires adjacentes et renvoyé au format `Float64` ; il est donc arrondi à la précision de `Float64`. La fonction consomme donc `O(n)` de mémoire, où `n` est le nombre de valeurs fournies. Les valeurs `NaN` sont ignorées, tandis que les valeurs infinies et négatives sont rejetées.

**Syntaxe**

```sql theme={null}
gini(expr)
```

**Arguments**

* `expr` — Expression produisant des valeurs numériques finies et positives ou nulles. [`(U)Int*`](/docs/fr/reference/data-types/int-uint), [`Float*`](/docs/fr/reference/data-types/float) ou [`Decimal`](/docs/fr/reference/data-types/decimal)

**Valeur renvoyée**

Le coefficient de Gini, ou `NaN` s'il y a moins de 2 valeurs ou si leur somme est égale à 0. [`Float64`](/docs/fr/reference/data-types/float)

**Exemples**

**Valeurs égales**

```sql title=Query theme={null}
SELECT gini(x) FROM (SELECT 100 AS x FROM numbers(10));
```

```response title=Response theme={null}
┌─gini(x)─┐
│       0 │
└─────────┘
```

**Distribution asymétrique**

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

```response title=Response theme={null}
┌─────────────gini(x)─┐
│ 0.36666666666666664 │
└─────────────────────┘
```