quantileExactWeighted

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

Точно вычисляет квантиль числовой последовательности с учетом веса каждого элемента.

Чтобы получить точное значение, все переданные значения объединяются в массив, который затем частично сортируется. Каждое значение учитывается с соответствующим весом, как будто оно встречается weight раз. В алгоритме используется хеш-таблица. Поэтому, если переданные значения часто повторяются, функция потребляет меньше оперативной памяти, чем quantileExact. Эту функцию можно использовать вместо quantileExact, указав вес 1.

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

Синтаксис

quantileExactWeighted(level)(expr, weight)

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

Параметры

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

Аргументы

• expr — Выражение над значениями столбца, результатом которого является числовой тип данных, Date, DateTime или DateTime64. (U)Int* или Int128 или UInt128 или Int256 или UInt256 или Float* или Decimal* или Date или DateTime или DateTime64
• weight — Столбец с весами элементов последовательности. Вес — это количество вхождений значения. UInt*

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

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

Примеры

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

CREATE TABLE t (
    n Int32,
    val UInt32
) ENGINE = Memory;

-- Insert the sample data
INSERT INTO t VALUES
(0, 3),
(1, 2),
(2, 1),
(5, 4);

SELECT quantileExactWeighted(n, val) FROM t;

┌─quantileExactWeighted(n, val)─┐
│                             1 │
└───────────────────────────────┘

См. также

• median
• quantiles