quantileExactHigh

Добавленный в: v20.8.0

Подобно quantileExact, эта функция вычисляет точный квантиль числовой последовательности данных.

Чтобы получить точное значение, все переданные значения объединяются в массив, который затем полностью сортируется. Сложность алгоритма сортировки составляет O(N·log(N)), где N = std::distance(first, last).

Возвращаемое значение зависит от уровня квантиля и количества элементов в выборке: если уровень равен 0.5, то для чётного числа элементов функция возвращает большее из двух средних значений, а для нечётного — средний элемент. Медиана вычисляется аналогично реализации median_high, используемой в Python.

Для всех остальных уровней возвращается элемент с индексом, соответствующим значению level * size_of_array.

При использовании нескольких функций quantile* с разными уровнями в одном запросе их внутренние состояния не объединяются (то есть запрос работает менее эффективно, чем мог бы). В этом случае используйте функцию quantiles.

Синтаксис

quantileExactHigh(level)(expr)

Псевдонимы: medianExactHigh

Параметры

level — Необязательный параметр. Уровень квантиля. Константное число с плавающей запятой от 0 до 1. Рекомендуем использовать значение level в диапазоне [0.01, 0.99]. Значение по умолчанию: 0.5. При level=0.5 функция вычисляет медиану. Float*

Аргументы

expr — Выражение по значениям столбца, возвращающее числовой тип данных, Date, DateTime или DateTime64. (U)Int* или Float* или Decimal* или Date или DateTime или DateTime64

Возвращаемое значение

Возвращает квантиль указанного уровня. Для числовых типов данных выходной формат соответствует входному формату. (U)Int* или Float* или Decimal* или Date или DateTime или DateTime64

Примеры

Вычисление точного верхнего квантиля

SELECT quantileExactHigh(number) FROM numbers(10);

┌─quantileExactHigh(number)─┐
│                         5 │
└───────────────────────────┘

Вычисление квантиля заданного уровня

SELECT quantileExactHigh(0.1)(number) FROM numbers(10);

┌─quantileExactHigh(0.1)(number)─┐
│                              1 │
└────────────────────────────────┘