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

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

Определяет, что происходит, когда число уникальных ключей агрегации превышает лимит:

• throw: сгенерировать исключение
• break: остановить выполнение запроса и вернуть частичный результат
• any: продолжить агрегацию для ключей, попавших в набор, но не добавлять в него новые ключи.

Использование значения any позволяет выполнить приблизительный вариант GROUP BY. Качество этого приближения зависит от статистической природы данных.

Для enable_group_by_top_k_optimization: количество строк, наблюдаемых каждым потоком агрегации перед заморозкой полной кучи top-K, которая пропустила менее 10 % входных строк и вытеснила меньше ключей, чем её вместимость. Замороженная куча означает, что агрегация продолжается так, как если бы оптимизация была отключена.

Фактическое окно как минимум вдвое превышает зарезервированный размер кучи, поэтому куча всегда успевает заполниться до оценки. 0 отключает эту заморозку (куча всё равно замораживается, если граничный набор равных значений разрастается сверх её размера).

Это не влияет на запросы GROUP BY keys LIMIT K без ORDER BY, для которых заморозка всегда отключена: план такого запроса содержит синтезированную сортировку, которая оправдана лишь пока куча ограничивает хеш-таблицу, поэтому заморозка кучи сделала бы план медленнее, чем без оптимизации.

При каком количестве ключей начинается двухуровневая агрегация. 0 — порог не задан.

Минимальный размер состояния агрегации в байтах, при котором начинает использоваться двухуровневая агрегация. 0 — порог не задан. Двухуровневая агрегация используется, когда срабатывает хотя бы один из порогов.

Изменяет способ обработки типов ключей агрегации в секции GROUP BY. Когда используются спецификаторы ROLLUP, CUBE или GROUPING SETS, некоторые ключи агрегации могут не участвовать в формировании отдельных строк результата. Столбцы для этих ключей в соответствующих строках заполняются либо значением по умолчанию, либо NULL — в зависимости от этой настройки.

Возможные значения:

• 0 — Для заполнения отсутствующих значений используется значение по умолчанию для типа ключа агрегации.
• 1 — ClickHouse выполняет GROUP BY в соответствии со стандартом SQL. Типы ключей агрегации преобразуются в Nullable. Столбцы соответствующих ключей агрегации заполняются значением NULL в строках, где эти ключи не использовались.

См. также:

• секция GROUP BY