Функции квантилей

quantiles

Синтаксис: quantiles(level1, level2, ...)(x)

Для всех функций квантилей существуют соответствующие функции quantiles: quantiles, quantilesDeterministic, quantilesTiming, quantilesTimingWeighted, quantilesExact, quantilesExactWeighted, quantileExactWeightedInterpolated, quantileInterpolatedWeighted, quantilesTDigest, quantilesBFloat16, quantilesDD. Эти функции вычисляют все квантили перечисленных уровней за один проход и возвращают массив полученных значений.

quantilesExactExclusive

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

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

Эта функция эквивалентна функции Excel PERCENTILE.EXC (тип R6, см. описание).

Работает эффективнее с наборами уровней, чем quantileExactExclusive.

Синтаксис

quantilesExactExclusive(level1, level2, ...)(expr)

Аргументы

• expr — Выражение над значениями столбца, результатом которого могут быть числовые типы данных, Date или DateTime.

Параметры

• level — Уровни квантилей. Возможные значения: (0, 1) — границы не включаются. Float.

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

• Array квантилей для указанных уровней.

Тип значений массива:

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

Пример

Запрос:

CREATE TABLE num AS numbers(1000);

SELECT quantilesExactExclusive(0.25, 0.5, 0.75, 0.9, 0.95, 0.99, 0.999)(x) FROM (SELECT number AS x FROM num);

Результат:

┌─quantilesExactExclusive(0.25, 0.5, 0.75, 0.9, 0.95, 0.99, 0.999)(x)─┐
│ [249.25,499.5,749.75,899.9,949.9499999999999,989.99,998.999]        │
└─────────────────────────────────────────────────────────────────────┘

quantilesExactInclusive

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

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

Эта функция эквивалентна функции Excel PERCENTILE.INC (тип R7).

Работает эффективнее с наборами уровней, чем quantileExactInclusive.

Синтаксис

quantilesExactInclusive(level1, level2, ...)(expr)

Аргументы

• expr — Выражение над значениями столбца, результатом которого являются числовые типы данных, Date или DateTime.

Параметры

• level — Уровни квантилей. Возможные значения: [0, 1] — границы включены. Float.

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

• Array квантилей заданных уровней.

Тип значений массива:

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

Пример

Запрос:

CREATE TABLE num AS numbers(1000);

SELECT quantilesExactInclusive(0.25, 0.5, 0.75, 0.9, 0.95, 0.99, 0.999)(x) FROM (SELECT number AS x FROM num);

Результат:

┌─quantilesExactInclusive(0.25, 0.5, 0.75, 0.9, 0.95, 0.99, 0.999)(x)─┐
│ [249.75,499.5,749.25,899.1,949.05,989.01,998.001]                   │
└─────────────────────────────────────────────────────────────────────┘

quantilesGK

quantilesGK работает аналогично функции quantileGK, но позволяет вычислять квантили для нескольких уровней одновременно и возвращает массив.

Синтаксис

quantilesGK(accuracy, level1, level2, ...)(expr)

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

• Array квантилей заданных уровней.

Тип значений массива:

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

Пример

Запрос:

SELECT quantilesGK(1, 0.25, 0.5, 0.75)(number + 1)
FROM numbers(1000)

┌─quantilesGK(1, 0.25, 0.5, 0.75)(plus(number, 1))─┐
│ [1,1,1]                                          │
└──────────────────────────────────────────────────┘

SELECT quantilesGK(10, 0.25, 0.5, 0.75)(number + 1)
FROM numbers(1000)

┌─quantilesGK(10, 0.25, 0.5, 0.75)(plus(number, 1))─┐
│ [156,413,659]                                     │
└───────────────────────────────────────────────────┘
SELECT quantilesGK(100, 0.25, 0.5, 0.75)(number + 1)
FROM numbers(1000)

┌─quantilesGK(100, 0.25, 0.5, 0.75)(plus(number, 1))─┐
│ [251,498,741]                                      │
└────────────────────────────────────────────────────┘

SELECT quantilesGK(1000, 0.25, 0.5, 0.75)(number + 1)
FROM numbers(1000)

┌─quantilesGK(1000, 0.25, 0.5, 0.75)(plus(number, 1))─┐
│ [249,499,749]                                       │
└─────────────────────────────────────────────────────┘