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

> Renvoie un tableau des valeurs estimées parmi les plus fréquentes dans la colonne spécifiée. Le tableau obtenu est trié par ordre décroissant de fréquence approximative des valeurs (et non selon les valeurs elles-mêmes). De plus, le poids de la valeur est pris en compte.

# topKWeighted

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

Introduit dans : v1.1.0

Renvoie un tableau des valeurs estimées comme étant les plus fréquentes dans la colonne spécifiée.
Le tableau résultant est trié par ordre décroissant de la fréquence approximative des valeurs (et non des valeurs elles-mêmes).
De plus, le poids de la valeur est pris en compte.

**Voir aussi**

* [topK](/fr/reference/functions/aggregate-functions/topK)
* [approx\_top\_k](/fr/reference/functions/aggregate-functions/approxtopk)
* [approx\_top\_sum](/fr/reference/functions/aggregate-functions/approxtopsum)

**Syntaxe**

```sql theme={null}
topKWeighted(N)(column, weight)
topKWeighted(N, load_factor)(column, weight)
topKWeighted(N, load_factor, 'counts')(column, weight)
```

**Paramètres**

* `N` — Le nombre d’éléments à renvoyer. Valeur par défaut : 10. [`UInt64`](/fr/reference/data-types/int-uint)
* `load_factor` — Facultatif. Définit le nombre de cellules réservées pour les valeurs. Si `uniq(column) > N * load_factor`, le résultat de la fonction topK sera approximatif. Valeur par défaut : 3. [`UInt64`](/fr/reference/data-types/int-uint)
* `counts` — Facultatif. Indique si le résultat doit contenir un décompte approximatif et une valeur d’erreur. [`Bool`](/fr/reference/data-types/boolean)

**Arguments**

* `column` — Le nom de la colonne pour laquelle trouver les valeurs les plus fréquentes. - `weight` — Le poids. Chaque valeur est comptabilisée `weight` fois dans le calcul de la fréquence. [`UInt64`](/fr/reference/data-types/int-uint)

**Valeur renvoyée**

Renvoie un tableau contenant les valeurs dont la somme approximative des poids est la plus élevée. [`Array`](/fr/reference/data-types/array)

**Exemples**

**Exemple d’utilisation**

```sql title=Query theme={null}
SELECT topKWeighted(2)(k, w) FROM
VALUES('k Char, w UInt64', ('y', 1), ('y', 1), ('x', 5), ('y', 1), ('z', 10));
```

```response title=Response theme={null}
┌─topKWeighted(2)(k, w)──┐
│ ['z','x']              │
└────────────────────────┘
```

**Avec le paramètre counts**

```sql title=Query theme={null}
SELECT topKWeighted(2, 10, 'counts')(k, w)
FROM VALUES('k Char, w UInt64', ('y', 1), ('y', 1), ('x', 5), ('y', 1), ('z', 10));
```

```response title=Response theme={null}
┌─topKWeighted(2, 10, 'counts')(k, w)─┐
│ [('z',10,0),('x',5,0)]              │
└─────────────────────────────────────┘
```

**Voir aussi**

* [topK](/fr/reference/functions/aggregate-functions/topK)
* [approx\_top\_k](/fr/reference/functions/aggregate-functions/approxtopk)
* [approx\_top\_sum](/fr/reference/functions/aggregate-functions/approxtopsum)