AggregateFunction
Агрегатные функции имеют промежуточное состояние, определяемое реализацией, которое может быть сериализовано в тип данных AggregateFunction(...) и храниться в таблице, обычно, с помощью материализованного представления.
Общий способ получения состояния агрегатной функции заключается в вызове агрегатной функции с суффиксом -State.
Чтобы получить окончательный результат агрегации в будущем, необходимо использовать ту же агрегатную функцию с суффиксом -Merge.
AggregateFunction(name, types_of_arguments...) — параметрический тип данных.
Параметры
-
Название агрегатной функции. Если функция параметрическая, укажите и её параметры.
-
Типы аргументов агрегатной функции.
Пример
uniq, anyIf (any+If) и quantiles — это агрегатные функции, поддерживаемые в ClickHouse.
Использование
Вставка данных
Для вставки данных используйте INSERT SELECT с агрегатными функциями -State.
Примеры функций
В отличие от соответствующих функций uniq и quantiles, функции -State возвращают состояние, вместо окончательного значения. Другими словами, они возвращают значение типа AggregateFunction.
В результатах запроса SELECT значения типа AggregateFunction имеют двоичное представление, специфичное для реализации, для всех форматов вывода ClickHouse. Если выгрузить данные, например, в формате TabSeparated с помощью запроса SELECT, то эту выгрузку можно загрузить обратно с помощью запроса INSERT.
Выбор данных
При выборе данных из таблицы AggregatingMergeTree используйте оператор GROUP BY и те же агрегатные функции, что и при вставке данных, но с суффиксом -Merge.
Агрегатная функция с суффиксом -Merge принимает набор состояний, объединяет их и возвращает результат полной агрегации данных.
Например, следующие два запроса возвращают один и тот же результат:
Пример использования
Смотрите описание движка AggregatingMergeTree.