Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

approx_top_k

View as MarkdownEdit this pageReport an issueSet up docs MCP

approx_top_k

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

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
  • 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

Arguments

  • column — Le nom de la colonne pour laquelle rechercher les valeurs les plus fréquentes. 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

Exemples

Exemple d'utilisation

SELECT approx_top_k(2)(k)
FROM VALUES('k Char, w UInt64', ('y', 1), ('y', 1), ('x', 5), ('y', 1), ('z', 10));
┌─approx_top_k(2)(k)────┐
│ [('y',3,0),('x',1,0)] │
└───────────────────────┘

Voir aussi

Navigation