> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-trino-dialect.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# настройки сеанса group_by_*
> Настройки сеанса ClickHouse в автоматически созданной группе group_by_*.
export const ExperimentalBadge = () => {
return
Экспериментальная возможность
;
};
export const VersionHistory = ({rows = []}) => {
if (rows.length === 0) {
return null;
}
const headers = ["Версия", "Значение по умолчанию", "Комментарий"];
const border = "1px solid rgba(128, 128, 128, 0.3)";
const cell = {
border,
padding: "0.25rem 0.5rem",
textAlign: "start",
verticalAlign: "top"
};
return
История версий
{headers.map(header => |
{header}
| )}
{rows.map((row, row_index) =>
{(row.items ?? []).map((item, item_index) => |
{item?.label}
| )}
)}
;
};
export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
return
Тип
{type}
По умолчанию
{default_value}
{changeable_without_restart &&
Изменяется без перезапуска
}
{changeable_without_restart &&
{changeable_without_restart}
}
;
};
Эти настройки доступны в [system.settings](/ru/reference/system-tables/settings) и автоматически генерируются на основе [исходного кода](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp).
## group\_by\_overflow\_mode
Определяет, что происходит, когда число уникальных ключей агрегации превышает лимит:
* `throw`: сгенерировать исключение
* `break`: остановить выполнение запроса и вернуть частичный результат
* `any`: продолжить агрегацию для ключей, попавших в набор, но не добавлять в него новые ключи.
Использование значения `any` позволяет выполнить приблизительный вариант GROUP BY. Качество
этого приближения зависит от статистической природы данных.
## group\_by\_top\_k\_optimization\_observation\_rows
Для `enable_group_by_top_k_optimization`: количество строк, наблюдаемых каждым потоком агрегации перед заморозкой полной кучи top-K, которая пропустила менее 10 % входных строк и вытеснила меньше ключей, чем её вместимость. Замороженная куча означает, что агрегация продолжается так, как если бы оптимизация была отключена.
Фактическое окно как минимум вдвое превышает зарезервированный размер кучи, поэтому куча всегда успевает заполниться до оценки. `0` отключает эту заморозку (куча всё равно замораживается, если граничный набор равных значений разрастается сверх её размера).
Это не влияет на запросы `GROUP BY keys LIMIT K` без `ORDER BY`, для которых заморозка всегда отключена: план такого запроса содержит синтезированную сортировку, которая оправдана лишь пока куча ограничивает хеш-таблицу, поэтому заморозка кучи сделала бы план медленнее, чем без оптимизации.
## group\_by\_two\_level\_threshold
При каком количестве ключей начинается двухуровневая агрегация. 0 — порог не задан.
## group\_by\_two\_level\_threshold\_bytes
Минимальный размер состояния агрегации в байтах, при котором начинает использоваться двухуровневая агрегация. 0 — порог не задан. Двухуровневая агрегация используется, когда срабатывает хотя бы один из порогов.
## group\_by\_use\_nulls
Изменяет способ обработки типов ключей агрегации в [секции GROUP BY](/ru/reference/statements/select/group-by).
Когда используются спецификаторы `ROLLUP`, `CUBE` или `GROUPING SETS`, некоторые ключи агрегации могут не участвовать в формировании отдельных строк результата.
Столбцы для этих ключей в соответствующих строках заполняются либо значением по умолчанию, либо `NULL` — в зависимости от этой настройки.
Возможные значения:
* 0 — Для заполнения отсутствующих значений используется значение по умолчанию для типа ключа агрегации.
* 1 — ClickHouse выполняет `GROUP BY` в соответствии со стандартом SQL. Типы ключей агрегации преобразуются в [Nullable](/ru/reference/data-types/nullable). Столбцы соответствующих ключей агрегации заполняются значением [NULL](/ru/reference/syntax#null) в строках, где эти ключи не использовались.
См. также:
* [секция GROUP BY](/ru/reference/statements/select/group-by)