aggregate_* настройки сеанса

Эти настройки доступны в system.settings и автоматически сгенерированы на основе исходного кода.

aggregate_function_input_format

Как входные форматы читают столбцы типа AggregateFunction. Возможные значения:

state — сериализованное состояние агрегатной функции в том виде, в каком его записывают выходные форматы (значение по умолчанию).
value — значение аргумента агрегатной функции или Tuple из аргументов, если их несколько. Значение агрегируется в состояние.
array — массив значений, описанных выше для параметра value. Все элементы массива агрегируются в состояние.

В режимах value и array формат читает столбец так, как если бы тот имел тип самих значений: T для AggregateFunction(f, T), Tuple(T1, T2) для AggregateFunction(f, T1, T2) или Array от них в режиме array. Значения записываются в том представлении, которое формат использует для этого типа: число или строка в текстовом формате, JSON-массив в JSON-форматах, двоичное кодирование типа в RowBinary или Native, столбец этого типа в Parquet и так далее. Это справедливо для любого входного формата, в том числе для AggregateFunction, вложенного в Array, Tuple или Map. Примеры Для таблицы со структурой:

CREATE TABLE example (
    user_id UInt64,
    avg_session_length AggregateFunction(avg, UInt32)
);

При aggregate_function_input_format = 'value':

INSERT INTO example FORMAT CSV
123,456

INSERT INTO example FORMAT JSONEachRow
{"user_id": 123, "avg_session_length": 456}

При aggregate_function_input_format = 'array':

INSERT INTO example FORMAT CSV
123,"[456,789,101]"

INSERT INTO example FORMAT JSONEachRow
{"user_id": 123, "avg_session_length": [456, 789, 101]}

Note: форматы value и array работают медленнее используемого по умолчанию формата state, поскольку требуют создания и агрегирования значений при вставке.

aggregate_functions_null_for_empty

Включает или отключает переписывание всех агрегатных функций в запросе, добавляя к ним суффикс -OrNull. Включите этот параметр для соответствия стандарту SQL. Это реализовано с помощью перезаписи запроса (аналогично настройке count_distinct_implementation), чтобы обеспечить согласованные результаты для распределённых запросов. Возможные значения:

0 — Отключено.
1 — Включено.

Пример Рассмотрим следующий запрос с агрегатными функциями:

SELECT SUM(-1), MAX(0) FROM system.one WHERE 0;

При aggregate_functions_null_for_empty = 0 получится:

┌─SUM(-1)─┬─MAX(0)─┐
│       0 │      0 │
└─────────┴────────┘

При aggregate_functions_null_for_empty = 1 результат будет таким:

┌─SUMOrNull(-1)─┬─MAXOrNull(0)─┐
│          NULL │         NULL │
└───────────────┴──────────────┘

Справочник по SQL

Типы данных

Движки

Функции

Форматы

Настройки

Системные таблицы

Озёра данных

aggregate_* настройки сеанса

aggregate_function_input_format

aggregate_functions_null_for_empty

​aggregate_function_input_format

​aggregate_functions_null_for_empty

aggregate_function_input_format

aggregate_functions_null_for_empty