> ## 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 les plus fréquentes de manière approximative dans la colonne spécifiée. Le tableau obtenu est trié par ordre décroissant de la fréquence approximative des valeurs (et non des valeurs elles-mêmes).

# topK

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

Introduit dans : v1.1.0

Renvoie un tableau des valeurs approximativement les plus fréquentes dans la colonne spécifiée. Le tableau résultant est trié par ordre décroissant de fréquence approximative des valeurs (et non selon les valeurs elles-mêmes).

Implémente l’algorithme [Filtered Space-Saving](https://doi.org/10.1016/j.ins.2010.08.024) pour l’analyse de TopK, sur la base de l’algorithme reduce-and-combine de [Parallel Space Saving](https://doi.org/10.1016/j.ins.2015.09.003).

Cette fonction ne fournit pas de résultat garanti. Dans certaines situations, des erreurs peuvent se produire et elle peut renvoyer des valeurs fréquentes qui ne sont pas les plus fréquentes.

**Voir aussi**

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

**Syntaxe**

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

**Paramètres**

* `N` — Le nombre d’éléments à renvoyer. Valeur par défaut : 10. Valeur maximale : `N = 65536`. [`UInt64`](/fr/reference/data-types/int-uint)
* `load_factor` — Facultatif. Définit le nombre de cellules réservées aux 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 nombre approximatif d’occurrences 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. [`String`](/fr/reference/data-types/string)

**Valeur renvoyée**

Renvoie un tableau des valeurs approximativement les plus fréquentes, triées par ordre décroissant de fréquence approximative. [`Array`](/fr/reference/data-types/array)

**Exemples**

**Exemple d’utilisation**

```sql title=Query theme={null}
SELECT topK(3)(AirlineID) AS res
FROM ontime;
```

```response title=Response theme={null}
┌─res─────────────────┐
│ [19393,19790,19805] │
└─────────────────────┘
```

**Voir aussi**

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