29.12. Параметры конфигурации #

Логическая репликация требует установки нескольких параметров конфигурации. Эти параметры актуальны только на одной стороне репликации.

29.12.1. Публикующие серверы #

Для wal_level должно быть установлено значение logical.

Для параметра max_replication_slots должно быть задано число не меньше ожидаемого числа подписчиков плюс некоторый резерв для синхронизации таблиц.

В работе слотов логической репликации также учитывается параметр idle_replication_slot_timeout.

В max_wal_senders должно быть значение как минимум равное max_replication_slots плюс число возможных физических реплик, работающих одновременно.

В работе передатчика данных логической репликации также учитывается параметр wal_sender_timeout.

29.12.2. Подписчики #

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

Для max_logical_replication_workers должно быть установлено значение, равное как минимум количеству подписок (для ведущих процессов применения), плюс некоторый резерв для рабочих процессов синхронизации таблиц и рабочих процессов параллельного применения.

Кроме того, может потребоваться изменить max_worker_processes, чтобы это число включало дополнительные рабочие процессы для репликации (как минимум max_logical_replication_workers + 1). Обратите внимание, что некоторые расширения и параллельные запросы также занимают слоты из числа max_worker_processes.

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

max_parallel_apply_workers_per_subscription управляет степенью распараллеливания для потоковой передачи незавершённых транзакций с параметром подписки streaming = parallel.

На рабочие процессы логической репликации также влияют параметры wal_receiver_timeout, wal_receiver_status_interval и wal_retrieve_retry_interval.

29.12. Configuration Settings #

Logical replication requires several configuration options to be set. These options are relevant only on one side of the replication.

29.12.1. Publishers #

wal_level must be set to logical.

max_replication_slots must be set to at least the number of subscriptions expected to connect, plus some reserve for table synchronization.

Logical replication slots are also affected by idle_replication_slot_timeout.

max_wal_senders should be set to at least the same as max_replication_slots, plus the number of physical replicas that are connected at the same time.

Logical replication walsender is also affected by wal_sender_timeout.

29.12.2. Subscribers #

max_active_replication_origins must be set to at least the number of subscriptions that will be added to the subscriber, plus some reserve for table synchronization.

max_logical_replication_workers must be set to at least the number of subscriptions (for leader apply workers), plus some reserve for the table synchronization workers and parallel apply workers.

max_worker_processes may need to be adjusted to accommodate for replication workers, at least (max_logical_replication_workers + 1). Note, some extensions and parallel queries also take worker slots from max_worker_processes.

max_sync_workers_per_subscription controls the amount of parallelism of the initial data copy during the subscription initialization or when new tables are added.

max_parallel_apply_workers_per_subscription controls the amount of parallelism for streaming of in-progress transactions with subscription parameter streaming = parallel.

Logical replication workers are also affected by wal_receiver_timeout, wal_receiver_status_interval and wal_retrieve_retry_interval.

FAQ