quantileTiming

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

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

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

Синтаксис

quantileTiming(level)(expr)

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

Аргументы

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

• expr — Выражение по значениям колонки, возвращающее число типа Float*.

  • Если функции передаются отрицательные значения, поведение не определено.
  • Если значение больше 30 000 (время загрузки страницы более 30 секунд), считается, что оно равно 30 000.

Точность

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

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

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

примечание

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

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

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

Тип: Float32.

примечание

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

Пример

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

┌─response_time─┐
│            72 │
│           112 │
│           126 │
│           145 │
│           104 │
│           242 │
│           313 │
│           168 │
│           108 │
└───────────────┘

Запрос:

SELECT quantileTiming(response_time) FROM t

Результат:

┌─quantileTiming(response_time)─┐
│                           126 │
└───────────────────────────────┘

См. также

• median
• quantiles