Настройки сеанса max_* - ClickHouse Documentation

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

max_analyze_depth

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

max_autoincrement_series

Ограничение на количество серий, создаваемых функцией generateSerialID. Поскольку каждая серия представляет собой узел в Keeper, не рекомендуется создавать более пары миллионов таких серий.

max_backup_bandwidth

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

max_block_size

В ClickHouse данные обрабатываются блоками, которые представляют собой наборы частей столбцов. Внутренние циклы обработки одного блока эффективны, но обработка каждого блока связана с заметными накладными расходами. Настройка max_block_size задаёт рекомендуемое максимальное число строк в одном блоке при чтении данных из таблиц. Блоки размером max_block_size не всегда считываются из таблицы: если ClickHouse определяет, что нужно получить меньше данных, обрабатывается блок меньшего размера. Размер блока не должен быть слишком маленьким, чтобы избежать заметных накладных расходов на обработку каждого блока. Но и слишком большим он тоже быть не должен, чтобы запросы с LIMIT выполнялись быстро после обработки первого блока. При настройке max_block_size следует стремиться не к чрезмерному расходу памяти при извлечении большого количества столбцов в нескольких потоках и сохранять хотя бы некоторую локальность кэша.

max_columns_to_read

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

Эта настройка полезна для предотвращения слишком сложных запросов.

Значение 0 означает отсутствие ограничений.

max_compress_block_size

Максимальный размер блоков несжатых данных перед их сжатием для записи в таблицу. По умолчанию — 1,048,576 (1 MiB). Указание меньшего размера блока обычно приводит к небольшому снижению коэффициента сжатия; при этом скорость сжатия и распаковки немного возрастает благодаря локальности кэша, а потребление памяти уменьшается.

Это настройка экспертного уровня, и вам не следует изменять её, если вы только начинаете работать с ClickHouse.

Не путайте блоки для сжатия (фрагмент памяти, состоящий из байтов) с блоками для обработки запросов (набор строк из таблицы).

max_consume_snapshots

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

max_estimated_execution_time

Максимальное оценочное время выполнения запроса в секундах. Проверяется для каждого блока данных после истечения timeout_before_checking_execution_speed.

max_expanded_ast_elements

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

max_fetch_partition_retries_count

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

max_final_threads

Задаёт максимальное количество параллельных потоков для фазы чтения данных в запросе SELECT с модификатором FINAL. Возможные значения:

Положительное целое число.
0 или 1 — отключено. Запросы SELECT выполняются в одном потоке.

max_http_get_redirects

Максимально допустимое число переходов по перенаправлениям HTTP GET. Обеспечивает дополнительную защиту от ситуации, когда вредоносный сервер перенаправляет ваши запросы к неожиданным сервисам.\n\nЭто возможно, когда внешний сервер перенаправляет на другой адрес, но этот адрес оказывается внутренним для инфраструктуры компании. В таком случае, отправив HTTP-запрос на внутренний сервер, вы можете обратиться к внутреннему API из внутренней сети, обойдя аутентификацию, или даже выполнить запрос к другим сервисам, таким как Redis или Memcached. Если у вас нет внутренней инфраструктуры (включая что-либо, работающее на вашем localhost) или вы доверяете серверу, перенаправления можно безопасно разрешить. Однако имейте в виду: если URL использует HTTP вместо HTTPS, вам придется доверять не только удаленному серверу, но и своему интернет-провайдеру, а также всем промежуточным сетям. Значение по умолчанию в Cloud: 10.

max_limit_for_vector_search_queries

Запросы SELECT с LIMIT больше этого значения не могут использовать индексы векторного сходства. Это помогает предотвратить переполнение памяти в индексах векторного сходства.

max_number_of_partitions_for_independent_aggregation

Максимальное число партиций в таблице для применения оптимизации

max_os_cpu_wait_time_ratio_to_throw

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

max_parallel_replicas

Максимальное количество реплик для каждого сегмента при выполнении запроса. Возможные значения:

Положительное целое число.

Дополнительная информация Этот параметр может давать разные результаты в зависимости от используемых настроек.

Параллельная обработка с использованием ключа `SAMPLE`

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

Положение ключа выборки в ключе партиционирования не позволяет эффективно выполнять диапазонное сканирование.
Добавление ключа выборки в таблицу снижает эффективность фильтрации по другим столбцам.
Ключ выборки представляет собой выражение, вычисление которого требует значительных затрат.
Распределение задержек в кластере имеет длинный хвост, поэтому выполнение запросов на большем числе серверов увеличивает их общую задержку.

Параллельная обработка с использованием parallel_replicas_custom_key

Этот параметр полезен для любой реплицируемой таблицы.

max_parsing_threads

Максимальное число потоков для разбора данных во входных форматах, поддерживающих параллельный разбор. По умолчанию определяется автоматически.

max_partition_size_to_drop

Ограничение на удаление партиций во время выполнения запроса. Значение 0 означает, что партиции можно удалять без каких-либо ограничений. Значение по умолчанию в Cloud: 1 TB.

Эта настройка запроса переопределяет соответствующую настройку сервера, см. max_partition_size_to_drop

max_parts_to_move

Ограничивает число частей, которые можно переместить в рамках одного запроса. Ноль означает отсутствие ограничений.

max_projection_rows_to_use_projection_index

Если количество строк, которые нужно прочитать из индекса проекции, меньше или равно этому порогу, ClickHouse попытается использовать индекс проекции при выполнении запроса.

max_query_size

Максимальное количество байтов в строке запроса, разбираемой SQL parser. Данные в предложении VALUES запросов INSERT обрабатываются отдельным потоковым parser (который потребляет O(1) оперативной памяти) и не подпадают под это ограничение.

max_query_size нельзя задать внутри SQL-запроса (например, SELECT now() SETTINGS max_query_size=10000), потому что ClickHouse нужно выделить буфер для разбора запроса, а размер этого буфера определяется настройкой max_query_size, которую необходимо настроить до выполнения запроса.

max_recursive_cte_evaluation_depth

Максимально допустимая глубина вычисления рекурсивного CTE

max_replica_delay_for_distributed_queries

Отключает отстающие реплики для распределённых запросов. См. Репликация. Задаёт время в секундах. Если отставание реплики больше или равно заданному значению, эта реплика не используется. Возможные значения:

Положительное целое число.
0 — Отставание реплик не проверяется.

Чтобы предотвратить использование любой реплики с ненулевым отставанием, установите этот параметр в 1. Используется при выполнении SELECT из distributed таблицы, которая указывает на реплицированные таблицы.

max_reverse_dictionary_lookup_cache_size_bytes

Максимальный размер в байтах кэша обратного поиска в словаре для каждого запроса, используемого функцией dictGetKeys. Кэш хранит сериализованные кортежи ключей для каждого значения атрибута, чтобы избежать повторного сканирования словаря в рамках одного запроса. При достижении лимита записи вытесняются по алгоритму LRU. Установите 0, чтобы отключить кэширование.

max_sessions_for_user

Максимальное количество одновременных сеансов для каждого прошедшего аутентификацию пользователя на сервере ClickHouse. Пример:

<profiles>
    <single_session_profile>
        <max_sessions_for_user>1</max_sessions_for_user>
    </single_session_profile>
    <two_sessions_profile>
        <max_sessions_for_user>2</max_sessions_for_user>
    </two_sessions_profile>
    <unlimited_sessions_profile>
        <max_sessions_for_user>0</max_sessions_for_user>
    </unlimited_sessions_profile>
</profiles>
<users>
    <!-- User Alice can connect to a ClickHouse server no more than once at a time. -->
    <Alice>
        <profile>single_session_user</profile>
    </Alice>
    <!-- User Bob can use 2 simultaneous sessions. -->
    <Bob>
        <profile>two_sessions_profile</profile>
    </Bob>
    <!-- User Charles can use arbitrarily many of simultaneous sessions. -->
    <Charles>
        <profile>unlimited_sessions_profile</profile>
    </Charles>
</users>

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

Положительное целое число
0 — неограниченное количество одновременных сеансов (по умолчанию)

max_subquery_depth

Если запрос содержит больше указанного числа вложенных подзапросов, генерируется исключение.

Это позволяет выполнять проверку на разумность и защищает от чрезмерно сложных запросов со стороны пользователей вашего кластера.

max_table_size_to_drop

Ограничение на удаление таблиц во время выполнения запроса. Значение 0 означает, что можно удалять любые таблицы без ограничений. Значение по умолчанию в Cloud: 1 ТБ.

Эта настройка запроса переопределяет соответствующую настройку сервера, см. max_table_size_to_drop

max_untracked_memory

Небольшие выделения и освобождения памяти группируются в локальной переменной потока и отслеживаются или профилируются только тогда, когда их объём (по абсолютной величине) превышает указанное значение. Если это значение больше, чем ‘memory_profiler_step’, оно фактически будет уменьшено до ‘memory_profiler_step’.

max_wkb_geometry_elements

Максимальное количество точек, колец или полигонов, допустимое в одном элементе WKB-геометрии при разборе функцией readWKB и связанными с ней функциями. Это защищает от чрезмерного выделения памяти из-за повреждённых данных WKB. Установите значение 0, чтобы использовать встроенное ограничение (100 миллионов).

​max_analyze_depth

​max_autoincrement_series

​max_backup_bandwidth

​max_block_size

​max_columns_to_read

​max_compress_block_size

​max_consume_snapshots

​max_estimated_execution_time

​max_expanded_ast_elements

​max_fetch_partition_retries_count

​max_final_threads

​max_http_get_redirects

​max_limit_for_vector_search_queries

​max_number_of_partitions_for_independent_aggregation

​max_os_cpu_wait_time_ratio_to_throw

​max_parallel_replicas

​Параллельная обработка с использованием ключа SAMPLE

​Параллельная обработка с использованием parallel_replicas_custom_key

​max_parsing_threads

​max_partition_size_to_drop

​max_parts_to_move

​max_projection_rows_to_use_projection_index

​max_query_size

​max_recursive_cte_evaluation_depth

​max_replica_delay_for_distributed_queries

​max_reverse_dictionary_lookup_cache_size_bytes

​max_sessions_for_user

​max_subquery_depth

​max_table_size_to_drop

​max_untracked_memory

​max_wkb_geometry_elements

max_analyze_depth

max_autoincrement_series

max_backup_bandwidth

max_block_size

max_columns_to_read

max_compress_block_size

max_consume_snapshots

max_estimated_execution_time

max_expanded_ast_elements

max_fetch_partition_retries_count

max_final_threads

max_http_get_redirects

max_limit_for_vector_search_queries

max_number_of_partitions_for_independent_aggregation

max_os_cpu_wait_time_ratio_to_throw

max_parallel_replicas

Параллельная обработка с использованием ключа `SAMPLE`

Параллельная обработка с использованием parallel_replicas_custom_key

max_parsing_threads

max_partition_size_to_drop

max_parts_to_move

max_projection_rows_to_use_projection_index

max_query_size

max_recursive_cte_evaluation_depth

max_replica_delay_for_distributed_queries

max_reverse_dictionary_lookup_cache_size_bytes

max_sessions_for_user

max_subquery_depth

max_table_size_to_drop

max_untracked_memory

max_wkb_geometry_elements