Passer au contenu principal

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
Query
SELECT topKWeighted(2)(k, w) FROM
VALUES('k Char, w UInt64', ('y', 1), ('y', 1), ('x', 5), ('y', 1), ('z', 10));
Response
┌─topKWeighted(2)(k, w)──┐
│ ['z','x']              │
└────────────────────────┘
Avec le paramètre counts
Query
SELECT topKWeighted(2, 10, 'counts')(k, w)
FROM VALUES('k Char, w UInt64', ('y', 1), ('y', 1), ('x', 5), ('y', 1), ('z', 10));
Response
┌─topKWeighted(2, 10, 'counts')(k, w)─┐
│ [('z',10,0),('x',5,0)]              │
└─────────────────────────────────────┘
Voir aussi
Dernière modification le 25 juin 2026