quantileExact

Точно вычисляет квантиль числовой последовательности данных.

Чтобы получить точное значение, все переданные значения объединяются в массив, который затем частично сортируется. Поэтому функция использует память объёма O(n), где n — количество переданных значений. Однако для небольшого числа значений функция очень эффективна.

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

Синтаксис

quantileExact(level)(expr)

Псевдоним: medianExact.

Аргументы

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

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

• Квантиль указанного уровня.

Тип:

• Для числовых типов данных формат результата будет таким же, как у входных данных. Например:

SELECT
    toTypeName(quantileExact(number)) AS `quantile`,
    toTypeName(quantileExact(number::Int32)) AS `quantile_int32`,
    toTypeName(quantileExact(number::Float32)) AS `quantile_float32`,
    toTypeName(quantileExact(number::Float64)) AS `quantile_float64`,
    toTypeName(quantileExact(number::Int64)) AS `quantile_int64`
FROM numbers(1)
   ┌─quantile─┬─quantile_int32─┬─quantile_float32─┬─quantile_float64─┬─quantile_int64─┐
1. │ UInt64   │ Int32          │ Float32          │ Float64          │ Int64          │
   └──────────┴────────────────┴──────────────────┴──────────────────┴────────────────┘

1 row in set. Elapsed: 0.002 sec.

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

Пример

Запрос:

SELECT quantileExact(number) FROM numbers(10)

Результат:

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

См. также

• median
• quantiles