Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

topKWeighted

topKWeighted

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

Syntaxe

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
  • 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
  • counts — Facultatif. Indique si le résultat doit contenir un décompte approximatif et une valeur d’erreur. Bool

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

Valeur renvoyée

Renvoie un tableau contenant les valeurs dont la somme approximative des poids est la plus élevée. Array

Exemples

Exemple d’utilisation

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

Avec le paramètre counts

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

Voir aussi

Navigation