quantileTimingWeighted

Появилась в версии: v1.1

С заданной точностью вычисляет квантиль числовой последовательности данных с учётом веса каждого элемента последовательности.

Результат является детерминированным (не зависит от порядка обработки запроса). Функция оптимизирована для работы с последовательностями, описывающими распределения, такие как время загрузки веб‑страниц или время ответа бэкенда.

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

Точность

Вычисление является точным, если:

Общее количество значений не превышает 5670.
Общее количество значений превышает 5670, но время загрузки страницы меньше 1024 мс.

В противном случае результат вычисления округляется до ближайшего кратного 16 мс.

Примечание

Для вычисления квантилей времени загрузки страниц эта функция более эффективна и точна, чем quantile.

Примечание

Если функции не передано ни одного значения (при использовании quantileTimingIf), возвращается NaN. Это позволяет отличать такие случаи от случаев с результатом, равным нулю. См. заметки о сортировке значений NaN в разделе предложение ORDER BY.

Синтаксис

quantileTimingWeighted(level)(expr, weight)

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

Параметры

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

Аргументы

expr — Выражение по значениям столбца, возвращающее число типа Float*. Если в функцию передаются отрицательные значения, поведение не определено. Если значение больше 30 000 (время загрузки страницы более 30 секунд), считается, что оно равно 30 000. Float*
weight — Столбец с весами элементов последовательности. Вес — это количество вхождений значения. UInt*

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

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

Примеры

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

CREATE TABLE t (response_time UInt32, weight UInt32) ENGINE = Memory;
INSERT INTO t VALUES (68, 1), (104, 2), (112, 3), (126, 2), (138, 1), (162, 1);

SELECT quantileTimingWeighted(response_time, weight) FROM t;

┌─quantileTimingWeighted(response_time, weight)─┐
│                                           112 │
└───────────────────────────────────────────────┘

quantileTimingWeighted​

quantileTimingWeighted