Passer au contenu principal

quantileTDigest

Introduit dans : v1.1.0 Calcule un quantile approximatif d’une séquence de données numériques à l’aide de l’algorithme t-digest. La consommation de mémoire est de log(n), où n représente un nombre de valeurs. Le résultat dépend de l’ordre d’exécution de la requête et n’est pas déterministe. Les performances de cette fonction sont inférieures à celles de quantile ou de quantileTiming. En termes de rapport entre la taille de l’état et la précision, cette fonction est bien meilleure que quantile. Lorsqu’on utilise plusieurs fonctions quantile* avec différents niveaux dans une requête, les états internes ne sont pas combinés (autrement dit, la requête s’exécute moins efficacement qu’elle ne le pourrait). Dans ce cas, utilisez la fonction quantiles. Syntaxe
quantileTDigest(level)(expr)
Alias : medianTDigest Paramètres
  • level — Facultatif. Niveau du quantile. Nombre constant à virgule flottante compris entre 0 et 1. Nous recommandons d’utiliser une valeur de level comprise dans l’intervalle [0.01, 0.99]. Valeur par défaut : 0.5. Avec level=0.5, la fonction calcule la médiane. Float*
Arguments
  • expr — Expression appliquée aux valeurs de la colonne, produisant des types de données numériques, Date ou DateTime. (U)Int* ou Float* ou Decimal* ou Date ou DateTime
Valeur de retour Quantile approximatif du niveau indiqué. Float64 ou Date ou DateTime Exemples Calcul d’un quantile avec t-digest
Query
SELECT quantileTDigest(number) FROM numbers(10);
Response
┌─quantileTDigest(number)─┐
│                     4.5 │
└─────────────────────────┘
Voir aussi
Dernière modification le 25 juin 2026