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

> Renvoie un tableau des valeurs approximativement les plus fréquentes et de leur nombre d'occurrences dans la colonne spécifiée.

# approx_top_k

<div id="approx_top_k">
  ## approx\_top\_k
</div>

Introduit dans : v1.1.0

Renvoie un tableau contenant une approximation des valeurs les plus fréquentes et de leur nombre d’occurrences dans la colonne spécifiée.
Le tableau obtenu est trié par fréquence approximative décroissante des valeurs (et non par les valeurs elles-mêmes).

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

**Syntaxe**

```sql theme={null}
approx_top_k(N[, reserved])(column)
```

**Alias** : `approx_top_count`

**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)
* `reserved` — Facultatif. Définit le nombre de cellules réservées aux valeurs. Si `uniq(column) > reserved`, le résultat sera approximatif. Valeur par défaut : `N * 3`. [`UInt64`](/fr/reference/data-types/int-uint)

**Arguments**

* `column` — Le nom de la colonne pour laquelle rechercher les valeurs les plus fréquentes. [`String`](/fr/reference/data-types/string)

**Valeur renvoyée**

Renvoie un tableau contenant les valeurs approximativement les plus fréquentes et leur nombre d'occurrences, triés par fréquence approximative décroissante. [`Array`](/fr/reference/data-types/array)

**Exemples**

**Exemple d'utilisation**

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

```response title=Response theme={null}
┌─approx_top_k(2)(k)────┐
│ [('y',3,0),('x',1,0)] │
└───────────────────────┘
```

**Voir aussi**

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