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

​
max_active_parts_loading_thread_pool_size

Количество потоков в пуле для загрузки активного набора частей данных при запуске.

​
max_authentication_methods_per_user

Максимальное количество методов аутентификации, с которыми можно создать пользователя или изменить его параметры. Изменение этой настройки не влияет на существующих пользователей. Запросы CREATE/ALTER, связанные с аутентификацией, завершатся ошибкой, если число методов превысит предел, указанный в этой настройке. Запросы CREATE/ALTER, не связанные с аутентификацией, будут выполняться успешно.
Значение 0 означает отсутствие ограничений.

​
max_backup_bandwidth_for_server

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

​
max_build_vector_similarity_index_thread_pool_size

Максимальное количество потоков, используемых для создания векторных индексов.
Значение 0 означает использование всех ядер.

​
max_connections

Максимальное число подключений к серверу.

​
max_entries_for_hash_table_stats

Сколько записей может содержать статистика хеш-таблицы, собираемая при агрегации

​
max_fetch_partition_thread_pool_size

Число потоков для ALTER TABLE FETCH PARTITION.

​
max_held_snapshots

Максимальное количество облегчённых снимков, которые можно удерживать одновременно. Ноль означает отсутствие ограничений. Если число снимков достигает этого предела, при попытке создать новый снимок будет сгенерировано исключение.

​
max_http_index_page_size

Максимальный размер ответа страницы HTTP-индекса, используемой для вывода содержимого каталога по HTTP. Если ответ превышает этот предел, запрос завершается ошибкой. По умолчанию: 10485760 (10 MiB).

​
max_keep_alive_requests

Максимальное количество запросов по одному keep-alive-соединению до его закрытия сервером ClickHouse. Пример

​
max_materialized_views_count_for_table

Ограничение на количество материализованных представлений, привязанных к таблице.
Здесь учитываются только представления, напрямую зависящие от таблицы; создание одного представления поверх другого не учитывается.

​
max_merges_bandwidth_for_server

Максимальная скорость чтения для всех слияний на сервере, в байтах в секунду. Ноль означает отсутствие ограничений.

​
max_mutations_bandwidth_for_server

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

​
max_open_files

Максимальное число открытых файлов.
Рекомендуем использовать этот параметр в macOS, поскольку функция getrlimit() возвращает некорректное значение.

​
max_os_cpu_wait_time_ratio_to_drop_connection

Максимальное соотношение времени ожидания CPU в ОС (метрика OSCPUWaitMicroseconds) ко времени занятости CPU (метрика OSCPUVirtualTimeMicroseconds), при котором может быть принято решение о разрыве соединений. Для вычисления вероятности используется линейная интерполяция между минимальным и максимальным значениями этого соотношения; в данной точке вероятность равна 1. Подробности см. в разделе Управление поведением при перегрузке CPU сервера.

​
max_outdated_parts_loading_thread_pool_size

Количество потоков для загрузки при запуске неактивного набора частей данных (устаревших).

​
max_part_num_to_warn

Если число активных частей превышает указанное значение, сервер ClickHouse добавит предупреждения в таблицу system.warnings. Пример

​
max_partition_size_to_drop

Ограничение на удаление партиций. Если размер таблицы MergeTree превышает max_partition_size_to_drop (в байтах), вы не сможете удалить партицию с помощью запроса DROP PARTITION. Для применения этой настройки не требуется перезапуск ClickHouse server. Ещё один способ отключить это ограничение — создать файл <clickhouse-path>/flags/force_drop_table.
Значение 0 означает, что партиции можно удалять без каких-либо ограничений.Это ограничение не распространяется на команды drop table и truncate table, см. max_table_size_to_drop
Пример

​
max_parts_cleaning_thread_pool_size

Количество потоков для одновременного удаления неактивных частей данных.

​
max_per_cpu_untracked_memory

Верхний предел неотслеживаемой памяти в байтах, который все потоки, работающие на одном CPU, могут суммарно удерживать одновременно до её передачи в трекер памяти. Если max_untracked_memory ограничивает один поток, то этот параметр ограничивает суммарный объём на CPU, чтобы множество потоков не могли превратить свой лимит на поток в большой общесерверный overcommit. Таким образом, общий объём неотслеживаемой памяти ограничен примерно значением number_of_cpus * max_per_cpu_untracked_memory. Значение 0 отключает ограничение на CPU (в этом случае действует только ограничение на поток max_untracked_memory). Только для Linux.

​
max_session_timeout

Максимальная длительность тайм-аута сеанса, в секундах. Пример:

​
max_temporary_data_on_disk_size

Максимальный объем хранилища, который может использоваться для внешней агрегации, JOIN или сортировки. Запросы, превышающие этот лимит, завершатся с ошибкой.
Значение 0 означает отсутствие ограничений.
См. также:

​
max_unexpected_parts_loading_thread_pool_size

Количество потоков для загрузки при запуске неактивного набора частей данных (Unexpected).

​
max_waiting_queries

Ограничение на общее число одновременно ожидающих запросов. Выполнение ожидающего запроса блокируется, пока необходимые таблицы асинхронно загружаются (см. async_load_databases.
Ожидающие запросы не учитываются при проверке ограничений, задаваемых следующими настройками:Это сделано, чтобы избежать достижения этих ограничений сразу после запуска сервера.
Значение 0 (по умолчанию) означает отсутствие ограничений.Эту настройку можно изменять во время выполнения, и она вступает в силу немедленно. Уже выполняющиеся запросы останутся без изменений.

​
max_zookeeper_pooled_connections

Максимальное количество лениво инициализируемых сеансов ZooKeeper для каждого кластера ZooKeeper в общем пуле. Значение 0 отключает пул соединений и оставляет использование одного сеанса.
Последнее изменение 23 июля 2026 г.