Skip to main content
Эти настройки доступны в system.merge_tree_settings и автоматически генерируются из исходного кода ClickHouse.

max_avg_part_size_for_too_many_parts

Проверка на «слишком большое количество частей» в соответствии с ‘parts_to_delay_insert’ и ‘parts_to_throw_insert’ будет выполняться только в том случае, если средний размер части (в соответствующей партиции) не превышает указанный порог. Если он превышает указанный порог, операции INSERT не будут ни задерживаться, ни отклоняться. Это позволяет хранить сотни терабайт в одной таблице на одном сервере, если части успешно сливаются в более крупные части. Это не влияет на пороги для неактивных частей или общего количества частей.

max_buckets_in_map

Максимальное количество бакетов для сериализации Map. Применяется к сериализации Map with_buckets. Фактическое количество бакетов определяется настройкой map_buckets_strategy. Максимально допустимое значение — 256.

max_cleanup_delay_period

Максимальный интервал очистки старых журналов очереди, хешей блоков и частей.

max_compress_block_size

Максимальный размер блоков несжатых данных перед сжатием при записи в таблицу. Этот параметр также можно указать в глобальных настройках (см. параметр max_compress_block_size). Значение, указанное при создании таблицы, переопределяет глобальное значение этого параметра.

max_concurrent_queries

Максимальное количество одновременно выполняемых запросов, связанных с таблицей семейства MergeTree. Запросы по-прежнему будут ограничиваться другими настройками max_concurrent_queries. Возможные значения:
  • Положительное целое число.
  • 0 — без ограничений.
Значение по умолчанию: 0 (без ограничений). Пример

max_digestion_size_per_segment

Устаревшая настройка, не имеет эффекта.

max_file_name_length

Максимальная длина имени файла, при которой оно сохраняется без хеширования. Действует, только если включена настройка replace_long_file_name_to_hash. Значение этой настройки не включает длину расширения файла. Поэтому рекомендуется задавать его меньше максимальной длины имени файла (обычно 255 байт), оставляя некоторый запас, чтобы избежать ошибок файловой системы.

max_partitions_to_read

Ограничивает максимальное количество партиций, к которым можно обратиться в рамках одного запроса. Значение настройки, указанное при создании таблицы, можно переопределить на уровне запроса. Возможные значения:
  • Любое положительное целое число.
Эту настройку ограничения сложности запроса max_partitions_to_read также можно задать на уровне запроса / сеанса / профиля.

max_projections

Максимальное количество проекций в MergeTree.

max_table_size_bytes_compressed

Если суммарный объём сжатых байт (размер на диске) по всем активным и неактивным частям данных таблицы превышает это значение, INSERT прерывается исключением Table size limit exceeded. Неактивные части также учитываются, поскольку цель этой настройки — ограничить использование диска. Обратите внимание, что неактивные части удаляются в фоновом режиме (см. настройку old_parts_lifetime), поэтому наблюдаемый размер со временем может уменьшаться. Ограничение проверяется в начале INSERT и при коммите новых частей данных в рабочий набор, включая результаты фоновых слияний и мутаций. Вставки, выполняемые materialized views, также проверяются. При репликационных загрузках ограничение не проверяется, из-за чего возможно состояние гонки, когда параллельные вставки в несколько реплик в сумме превышают ограничение. Коммит пустых частей данных разрешён всегда, поэтому данные можно удалить из таблицы, превысившей ограничение, например с помощью TRUNCATE или ALTER TABLE ... DROP PARTITION. Возможные значения:
  • Любое положительное целое число.
  • 0 — без ограничений.
Настройка полезна для мультитенантных, временных и демонстрационных сервисов.

max_table_size_bytes_uncompressed

То же, что и max_table_size_bytes_compressed, но ограничение применяется к суммарному объёму несжатых данных (в байтах) по всем активным и неактивным частям данных таблицы. Возможные значения:
  • Любое положительное целое число.
  • 0 — без ограничений.
Полезно для мультитенантных, временных и демонстрационных сервисов.

max_table_size_rows

Если общее число строк в активных частях данных таблицы превышает это значение, INSERT прерывается с исключением Table size limit exceeded. Ограничение проверяется в начале INSERT и при коммите новых частей данных в рабочий набор, включая результаты фоновых слияний и мутаций (поэтому мутация, увеличивающая размер таблицы сверх лимита, будет повторяться, так и не завершившись). Вставки, выполняемые materialized views, также проверяются. При репликационных загрузках ограничение не проверяется, что допускает состояние гонки, когда параллельные вставки в несколько реплик совместно превышают лимит. Коммит пустых частей данных разрешён всегда, поэтому данные можно удалить из таблицы, превысившей лимит, например с помощью TRUNCATE или ALTER TABLE ... DROP PARTITION. Возможные значения:
  • Любое положительное целое число.
  • 0 — без ограничений.
Полезно для мультитенантных, временных и демонстрационных сервисов.

max_uncompressed_bytes_in_patches

Максимальный общий несжатый размер данных во всех патч-частях в байтах. Если общий объём данных во всех патч-частях превышает это значение, легковесные обновления будут отклонены. 0 — без ограничений.
Последнее изменение 26 сентября 2026 г.