quantileTDigestWeighted

Вычисляет приближенный квантиль последовательности числовых данных с использованием алгоритма t-digest. Функция учитывает вес каждого элемента последовательности. Максимальная ошибка составляет 1%. Потребление памяти равно log(n), где n — количество значений.

Производительность функции ниже, чем у quantile или quantileTiming. В отношении соотношения размера состояния к точности данная функция значительно лучше, чем quantile.

Результат зависит от порядка выполнения запроса и является недетерминированным.

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

примечание

Использование quantileTDigestWeighted не рекомендуется для малых наборов данных и может привести к значительной ошибке. В этом случае рассмотрите возможность использования quantileTDigest вместо.

Синтаксис

quantileTDigestWeighted(level)(expr, weight)

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

Аргументы

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

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

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

Тип:

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

Пример

Запрос:

SELECT quantileTDigestWeighted(number, 1) FROM numbers(10)

Результат:

┌─quantileTDigestWeighted(number, 1)─┐
│                                4.5 │
└────────────────────────────────────┘

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