Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

quantileExactInclusive

quantileExactInclusive

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

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

Эта функция эквивалентна quantileExact, но использует инклюзивный метод вычисления квантилей, как описано в методе R-7.

При использовании этой функции квантиль вычисляется так, что формула интерполяции для заданного квантиля p имеет вид: x[floor((n-1)*p)] + ((n-1)*p - floor((n-1)*p)) * (x[floor((n-1)*p)+1] - x[floor((n-1)*p)]), где x — отсортированный массив.

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

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

Синтаксис

quantileExactInclusive(level)(expr)

Параметры

  • level — Уровень квантиля. Константное число с плавающей точкой от 0 до 1 включительно. Рекомендуется использовать значение level в диапазоне [0.01, 0.99]. Float*

Аргументы

  • expr — Выражение над значениями столбца, результатом которого являются числовые типы данных, Date или DateTime. (U)Int* или Float* или Date или DateTime

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

Возвращает квантиль указанного уровня. Float64

Примеры

Вычисление точного включающего квантиля

SELECT quantileExactInclusive(0.25)(number) FROM numbers(5);
┌─quantileExactInclusive(0.25)(number)─┐
│                                    1 │
└──────────────────────────────────────┘

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

SELECT quantileExactInclusive(0.1)(number), quantileExactInclusive(0.9)(number) FROM numbers(10);
┌─quantileExactInclusive(0.1)(number)─┬─quantileExactInclusive(0.9)(number)─┐
│                  0.8999999999999999 │                                 8.1 │
└─────────────────────────────────────┴─────────────────────────────────────┘
Navigation