ClickHouse/docs/ru/sql-reference/aggregate-functions/reference/quantile.md

3.0 KiB
Raw Blame History

toc_priority
200

quantile

Приблизительно вычисляет квантиль числовой последовательности.

Функция использует алгоритм reservoir sampling с размером резервуара до 8192 и случайным генератором чисел для для сэмплирования. Результат не детерминирован. Чтобы получить точную квантиль используйте функцию quantileExact.

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

Синтаксис

quantile(level)(expr)

Алиас: median.

Аргументы

  • level — уровень квантили. Опционально. Константное значение с плавающей запятой от 0 до 1. Мы рекомендуем использовать значение level из диапазона [0.01, 0.99]. Значение по умолчанию: 0.5. При level=0.5 функция вычисляет медиану.
  • expr — выражение, зависящее от значений столбцов, возвращающее данные числовых типов или типов Date, DateTime.

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

  • Приблизительный квантиль заданного уровня.

Тип:

  • Float64 для входных данных числового типа.
  • Date, если входные значения имеют тип Date.
  • DateTime, если входные значения имеют тип DateTime.

Пример

Входная таблица:

┌─val─┐
│   1 │
│   1 │
│   2 │
│   3 │
└─────┘

Запрос:

SELECT quantile(val) FROM t

Результат:

┌─quantile(val)─┐
│           1.5 │
└───────────────┘

Смотрите также