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
Dernière modification le 25 juin 2026