uniq

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

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

Функция использует алгоритм адаптивного сэмплирования. Для хранения состояния вычислений функция использует выборку хеш-значений элементов размером до 65536. Этот алгоритм очень точен и при этом очень эффективен по нагрузке на CPU. Если запрос содержит несколько таких функций, uniq работает почти так же быстро, как и другие агрегатные функции.

Подробности реализации

Эта функция вычисляет хеш для всех параметров агрегирования, а затем использует его в вычислениях. Она использует алгоритм адаптивного сэмплирования. Для хранения состояния вычислений функция использует выборку хеш-значений элементов размером до 65536. Этот алгоритм очень точен и при этом очень эффективен по нагрузке на CPU. Если запрос содержит несколько таких функций, uniq работает почти так же быстро, как и другие агрегатные функции.

Синтаксис

uniq(x[, ...])

Аргументы

x — Функция принимает переменное количество параметров. Tuple(T) или Array(T) или Date или DateTime или String или (U)Int* или Float* или Decimal

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

Возвращает число типа UInt64, представляющее приблизительное количество различных значений. UInt64

Примеры

Пример использования

CREATE TABLE example_table (
    id UInt32,
    category String,
    value Float64
) ENGINE = Memory;

INSERT INTO example_table VALUES
(1, 'A', 10.5),
(2, 'B', 20.3),
(3, 'A', 15.7),
(4, 'C', 8.9),
(5, 'B', 12.1),
(6, 'A', 18.4);

SELECT uniq(category) as unique_categories
FROM example_table;

┌─unique_categories─┐
│                 3 │
└───────────────────┘

Несколько аргументов

SELECT uniq(category, value) as unique_combinations
FROM example_table;

┌─unique_combinations─┐
│                   6 │
└─────────────────────┘

См. также