Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

quantilesDD

quantilesDD

Introduit dans : v24.1.0

Calcule simultanément plusieurs quantiles approximatifs d’un échantillon, à différents niveaux, avec des garanties d’erreur relative.

Cette fonction est équivalente à quantileDD, mais elle permet de calculer plusieurs niveaux de quantile en un seul passage, ce qui est plus efficace que d’appeler séparément des fonctions de quantile individuelles.

Syntaxe

quantilesDD(relative_accuracy, level1, level2, ...)(expr)

Paramètres

  • relative_accuracy — Précision relative des quantiles. Les valeurs possibles sont comprises entre 0 et 1. La valeur recommandée est de 0.001 ou plus. Float*
  • level — Niveaux des quantiles. Un ou plusieurs nombres à virgule flottante constants compris entre 0 et 1. Nous recommandons d'utiliser des valeurs de level comprises dans la plage [0.01, 0.99]. Float*

Arguments

  • expr — Expression appliquée aux valeurs de la colonne, produisant des types de données numériques, Date ou DateTime. (U)Int* or Float* or Date or DateTime

Valeur renvoyée

Tableau de quantiles approximatifs pour les niveaux spécifiés, dans le même ordre que celui dans lequel les niveaux ont été indiqués. Pour les entrées Date et DateTime, le format de sortie correspond au format d'entrée. Array(Float64) or Array(Date) or Array(DateTime)

Exemples

Calcul de plusieurs quantiles avec DDSketch

SELECT quantilesDD(0.01, 0.25, 0.5, 0.75)(number) FROM numbers(10)
┌─quantilesDD(0.01, 0.25, 0.5, 0.75)(number)────────────────┐
│ [1.9936617014173448,4.0148353330285875,5.989510371172621] │
└───────────────────────────────────────────────────────────┘
Navigation