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.