Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

Настройки сеанса parallel_replicas_*

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

parallel_replicas_allow_in_with_subquery

Тип
Bool
По умолчанию
1
История версий
ВерсияЗначение по умолчаниюКомментарий
24.31Если значение true, подзапрос для IN будет выполняться на каждой реплике-follower

Если значение true, подзапрос для IN будет выполняться на каждой реплике-follower.

parallel_replicas_allow_materialized_views

Тип
Bool
По умолчанию
1
История версий
ВерсияЗначение по умолчаниюКомментарий
25.121Разрешить использование материализованных представлений с параллельными репликами

Разрешить использование материализованных представлений с параллельными репликами

parallel_replicas_allow_view_over_mergetree

Возможность в статусе бета
Тип
Bool
По умолчанию
0
История версий
ВерсияЗначение по умолчаниюКомментарий
26.40новая настройка

Разрешает параллельным репликам выполнять внешний запрос простого представления над таблицами MergeTree (вместо внутреннего запроса представления), что улучшает распараллеливание между узлами. Также применяется к представлениям UNION ALL, все ветви которых читают из разных таблиц MergeTree.

parallel_replicas_connect_timeout_ms

Тип
Milliseconds
По умолчанию
300
История версий
ВерсияЗначение по умолчаниюКомментарий
25.6300Отдельный тайм-аут подключения для запросов с параллельными репликами

Тайм-аут в миллисекундах для подключения к удалённой реплике во время выполнения запроса в режиме параллельных реплик. Если тайм-аут истекает, соответствующая реплика не используется для выполнения запроса

parallel_replicas_count

Возможность в статусе бета
Тип
UInt64
По умолчанию
0

Это внутренняя настройка, её не следует использовать напрямую: она отражает детали реализации режима «параллельных реплик». Для распределённых запросов сервер-инициатор автоматически устанавливает её в значение, равное числу параллельных реплик, участвующих в обработке запроса.

parallel_replicas_custom_key

Возможность в статусе бета

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

Предпочтительны простые выражения на основе первичных ключей.

Если эта настройка используется в кластере, состоящем из одного сегмента и нескольких реплик, эти реплики будут преобразованы в виртуальные сегменты. В противном случае она будет работать так же, как ключ SAMPLE: будут использоваться несколько реплик каждого сегмента.

parallel_replicas_custom_key_range_lower

Возможность в статусе бета
Тип
UInt64
По умолчанию
0
История версий
ВерсияЗначение по умолчаниюКомментарий
24.60Добавлены настройки для управления фильтром диапазона при использовании параллельных реплик с динамическими сегментами

Позволяет фильтру типа range равномерно распределять нагрузку между репликами на основе пользовательского диапазона [parallel_replicas_custom_key_range_lower, INT_MAX].

При использовании вместе с parallel_replicas_custom_key_range_upper позволяет фильтру равномерно распределять нагрузку между репликами в диапазоне [parallel_replicas_custom_key_range_lower, parallel_replicas_custom_key_range_upper].

Примечание: эта настройка не приводит к дополнительной фильтрации данных при обработке запросов, а лишь изменяет точки, в которых фильтр диапазона разбивает диапазон [0, INT_MAX] для параллельной обработки.

parallel_replicas_custom_key_range_upper

Возможность в статусе бета
Тип
UInt64
По умолчанию
0
История версий
ВерсияЗначение по умолчаниюКомментарий
24.60Добавлены настройки для управления фильтром диапазона при использовании параллельных реплик с динамическими сегментами. Значение 0 отключает верхнюю границу

Позволяет фильтру типа range равномерно распределять работу между репликами на основе настраиваемого диапазона [0, parallel_replicas_custom_key_range_upper]. Значение 0 отключает верхнюю границу и устанавливает её равной максимальному значению выражения пользовательского ключа.

При использовании вместе с parallel_replicas_custom_key_range_lower эта настройка позволяет фильтру равномерно распределять работу между репликами для диапазона [parallel_replicas_custom_key_range_lower, parallel_replicas_custom_key_range_upper].

Примечание: эта настройка сама по себе не приводит к дополнительной фильтрации данных при обработке запроса, а лишь изменяет точки, в которых фильтр диапазона разбивает диапазон [0, INT_MAX] для параллельной обработки

parallel_replicas_filter_pushdown

Возможность в статусе бета
Тип
Bool
По умолчанию
0
История версий
ВерсияЗначение по умолчаниюКомментарий
26.20новая настройка

Разрешить pushdown фильтров в ту часть запроса, которую выполняют параллельные реплики

parallel_replicas_for_cluster_engines

Тип
Bool
По умолчанию
1
История версий
ВерсияЗначение по умолчаниюКомментарий
25.31Новая настройка

Заменяет движки табличных функций на соответствующие варианты -Cluster

parallel_replicas_for_non_replicated_merge_tree

Тип
Bool
По умолчанию
0

Если установлено значение true, ClickHouse будет использовать алгоритм параллельных реплик и для нереплицируемых таблиц семейства MergeTree

parallel_replicas_index_analysis_only_on_coordinator

Тип
Bool
По умолчанию
1
История версий
ВерсияЗначение по умолчаниюКомментарий
24.121Анализ индекса выполняется только на реплике-координаторе и не выполняется на других репликах. Действует только при включенном parallel_replicas_local_plan
24.101Анализ индекса выполняется только на реплике-координаторе и не выполняется на других репликах. Действует только при включенном parallel_replicas_local_plan

Анализ индекса выполняется только на реплике-координаторе и не выполняется на других репликах. Действует только при включенном parallel_replicas_local_pla

parallel_replicas_insert_select_local_pipeline

Тип
Bool
По умолчанию
1
История версий
ВерсияЗначение по умолчаниюКомментарий
25.51Использовать локальный конвейер при распределённом INSERT SELECT с параллельными репликами. В настоящее время отключено из-за проблем с производительностью
25.40Использовать локальный конвейер при распределённом INSERT SELECT с параллельными репликами. В настоящее время отключено из-за проблем с производительностью

Использовать локальный конвейер при распределённом INSERT SELECT с параллельными репликами

parallel_replicas_local_plan

Тип
Bool
По умолчанию
1
История версий
ВерсияЗначение по умолчаниюКомментарий
24.90Использовать локальный план для локальной реплики в запросе с параллельными репликами
24.111Использовать локальный план для локальной реплики в запросе с параллельными репликами
24.101Использовать локальный план для локальной реплики в запросе с параллельными репликами

Использовать локальный план для локальной реплики

parallel_replicas_mark_segment_size

Тип
UInt64
По умолчанию
0
История версий
ВерсияЗначение по умолчаниюКомментарий
24.90Значение этого параметра теперь определяется автоматически
24.1128Добавлена новая настройка для управления размером сегмента в новой реализации координатора параллельных реплик

Части логически разбиваются на сегменты, которые распределяются между репликами для параллельного чтения. Этот параметр задаёт размер этих сегментов. Не рекомендуется изменять его, пока вы не будете полностью уверены в том, что делаете. Значение должно находиться в диапазоне [128; 16384]

parallel_replicas_min_number_of_rows_per_replica

Тип
UInt64
По умолчанию
0

Ограничивает число реплик, используемых в запросе, значением (оценочное количество строк для чтения / min_number_of_rows_per_replica). Максимальное значение по-прежнему ограничено параметром 'max_parallel_replicas'

parallel_replicas_mode

Тип
ParallelReplicasMode
По умолчанию
read_tasks
История версий
ВерсияЗначение по умолчаниюКомментарий
24.10read_tasksЭтот параметр был добавлен при переводе возможности параллельных реплик в статус бета

Тип фильтра, используемого с пользовательским ключом для параллельных реплик. default — использовать операцию modulo для пользовательского ключа, range — использовать фильтр диапазона для пользовательского ключа с применением всех возможных значений типа значения этого ключа.

parallel_replicas_only_with_analyzer

Тип
Bool
По умолчанию
1
История версий
ВерсияЗначение по умолчаниюКомментарий
25.21Параллельные реплики поддерживаются только при включенном анализаторе

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

parallel_replicas_plan_based

Экспериментальная возможность
Тип
Bool
По умолчанию
0
История версий
ВерсияЗначение по умолчаниюКомментарий
26.70новая настройка

Определяет, следует ли использовать параллельные реплики и где именно, на основе анализа плана запроса, а не дерева запроса. В результате удалённым репликам вместо SQL-запроса отправляется фрагмент плана. Экспериментальная.

parallel_replicas_prefer_local_join

Тип
Bool
По умолчанию
1
История версий
ВерсияЗначение по умолчаниюКомментарий
24.21Если `true`, и JOIN можно выполнить с помощью алгоритма параллельных реплик, а все хранилища правой части JOIN — таблицы семейства *MergeTree, будет использоваться локальный JOIN вместо GLOBAL JOIN.

Если true, и JOIN можно выполнить с помощью алгоритма параллельных реплик, а все хранилища правой части JOIN — таблицы семейства *MergeTree, будет использоваться локальный JOIN вместо GLOBAL JOIN.

parallel_replicas_prefer_local_replica

Тип
Bool
По умолчанию
1
История версий
ВерсияЗначение по умолчаниюКомментарий
26.51Новая настройка. Если отключена, реплики для параллельного чтения выбираются исключительно алгоритмом балансировки нагрузки, без принудительного включения локальной реплики в набор.

Если включено (по умолчанию), локальная реплика всегда включается в набор реплик, используемых для параллельного чтения. Если отключено, локальной реплике не отдается предпочтение, и реплики выбираются исключительно алгоритмом балансировки нагрузки. Это позволяет направлять запросы с max_parallel_replicas = 1 на другой хост, что может улучшить локальность кэша, когда множество коротких запросов распределено по кластеру.

parallel_replicas_support_projection

Тип
Bool
По умолчанию
1
История версий
ВерсияЗначение по умолчаниюКомментарий
25.81Новая настройка. Оптимизация проекций может использоваться в параллельных репликах. Действует только при включенном parallel_replicas_local_plan и отключенном aggregation_in_order.

Оптимизация проекций может использоваться в параллельных репликах. Действует только при включенном parallel_replicas_local_plan и отключенном aggregation_in_order.

Navigation