Перейти к основному содержимому
Перейти к основному содержимому

AggregateFunction

Агрегатные функции имеют промежуточное состояние с определением реализации, которое может быть сериализовано в тип данных AggregateFunction(...) и сохранено в таблице, обычно с помощью материализованного представления. Общий способ получения состояния агрегатной функции заключается в вызове агрегатной функции с суффиксом -State. Чтобы получить окончательный результат агрегации в будущем, вы должны использовать ту же агрегатную функцию с суффиксом -Merge.

AggregateFunction(name, types_of_arguments...) — параметрический тип данных.

Параметры

  • Имя агрегатной функции. Если функция параметрическая, укажите также её параметры.

  • Типы аргументов агрегатной функции.

Пример

uniq, anyIf (any+If) и quantiles являются агрегатными функциями, поддерживаемыми в ClickHouse.

Usage

Data Insertion

Чтобы вставить данные, используйте INSERT SELECT с агрегатными функциями -State.

Примеры функций

В отличие от соответствующих функций uniq и quantiles, функции с суффиксом -State возвращают состояние, вместо окончательного значения. Другими словами, они возвращают значение типа AggregateFunction.

В результатах запроса SELECT значения типа AggregateFunction имеют специфическое для реализации двоичное представление для всех форматов вывода ClickHouse. Если экспортировать данные, например, в формате TabSeparated с помощью запроса SELECT, то этот экспорт можно загрузить обратно с помощью запроса INSERT.

Data Selection

При выборке данных из таблицы AggregatingMergeTree используйте оператор GROUP BY и те же агрегатные функции, что и при вставке данных, но с использованием суффикса -Merge.

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

Например, следующие два запроса возвращают один и тот же результат:

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

Смотрите описание двигателя AggregatingMergeTree.