18.6. Репликация
Эти параметры управляют поведением встроенного механизма потоковой репликации (см. Подраздел 25.2.5). Когда он применяется, один сервер является ведущим, а другие — ведомыми. Ведущий сервер всегда передаёт данные, а ведомые всегда принимают данные репликации, но когда настроена каскадная репликация (см. Подраздел 25.2.7), ведомые серверы также могут быть и передающими. Большинство следующих параметров относится к передающим и ведомым серверам, но есть несколько параметров, которые имеют смысл только для ведущего. Все эти параметры вполне могут быть разными в рамках одного кластера, если это требуется.
18.6.1. Передающие серверы
Эти параметры можно задать на любом сервере, который передаёт данные репликации одному или нескольким ведомым. Ведущий сервер всегда является передающим, так что на нём они должны задаваться всегда. Роль и значение этих параметров не меняются после того, как ведомый сервер становится ведущим.
max_wal_senders(integer)Задаёт максимально допустимое число одновременных подключений ведомых серверов или клиентов потокового копирования (т. е. максимальное количество одновременно работающих процессов передачи WAL). По умолчанию это значение равно нулю, то есть репликация отключается. Передающие WAL процессы учитываются в общем числе соединений, так что этот параметр не может превышать max_connections. В случае неожиданного отключения клиента потоковой передачи слот подключения может оставаться занятым до достижения тайм-аута, так что этот параметр должен быть немного больше максимально допустимого числа клиентов, чтобы отключившиеся клиенты могли переподключиться немедленно. Задать этот параметр можно только при запуске сервера. Чтобы к данному серверу могли подключаться ведомые, уровень
wal_levelдолжен бытьreplicaили выше.max_replication_slots(integer)Задаёт максимальное число слотов репликации (см. Подраздел 25.2.6), которое сможет поддерживать сервер. Значение по умолчанию — ноль. Этот параметр можно задать только при запуске сервера. Чтобы эти слоты репликации можно было использовать, уровень
wal_levelдолжен бытьreplicaили выше. Если заданное значение данного параметра будет меньше, чем число уже существующих слотов репликации, сервер не запустится.wal_keep_segments(integer)Задаёт минимальное число файлов прошлых сегментов журнала, которые будут сохраняться в каталоге
pg_xlog, чтобы ведомый сервер мог выбрать их при потоковой репликации. Обычно сегмент имеет размер 16 мегабайт. Если ведомый сервер, подключённый к передающему, отстаёт больше чем наwal_keep_segmentsсегментов, передающий удаляет сегменты WAL, всё ещё необходимые ведомому, и в этом случае соединение репликации прерывается. В результате этого затем также будут прерваны зависимые соединения. (Однако ведомый сервер сможет восстановиться, выбрав этот сегмент из архива, если осуществляется архивация WAL.)Этот параметр задаёт только минимальное число сегментов, сохраняемое в каталоге
pg_xlog; система может сохранить больше сегментов для архивации WAL или для восстановления с момента контрольной точки. Еслиwal_keep_segmentsравен нулю (это значение по умолчанию), система не сохраняет никакие дополнительные сегменты для ведомых серверов, поэтому число старых сегментов WAL, доступных для ведомых серверов, зависит от положения предыдущей контрольной точки и состояния архивации WAL. Задать этот параметр можно только вpostgresql.confили в командной строке при запуске сервера.wal_sender_timeout(integer)Задаёт период времени (в миллисекундах), по истечении которого прерываются неактивные соединения репликации. Это помогает передающему серверу обнаружить сбой ведомого или разрывы сети. При значении, равном нулю, тайм-аут отключается. Задать этот параметр можно только в
postgresql.confили в командной строке при запуске сервера. Значение по умолчанию — 60 секунд.track_commit_timestamp(bool)Включает запись времени фиксации транзакций. Этот параметр можно задать только в
postgresql.confили в командной строке при запуске сервера. По умолчанию этот параметр имеет значениеoff.
18.6.2. Главный сервер
Эти параметры можно задать на главном/ведущем сервере, который должен передавать данные репликации одному или нескольким ведомым. Заметьте, что помимо этих параметров на ведущем сервере должен быть правильно установлен wal_level, а также может быть включена архивация WAL (см. Подраздел 18.5.3). Значения этих параметров на ведомых серверах не важны, хотя их можно подготовить заранее, на случай, если ведомый сервер придётся сделать ведущим.
synchronous_standby_names(string)Определяет список ведомых серверов, которые могут поддерживать синхронную репликацию, как описано в Подразделе 25.2.8. Активных синхронных ведомых серверов может быть один или несколько; транзакции, ожидающие фиксирования, будут завершаться только после того, как эти ведомые серверы подтвердят получение их данных. Синхронными ведомыми серверами будут те, имена которых указаны в начале этого списка и которые подключены к главному и принимают поток данных в реальном времени (что показывает признак
streamingв представленииpg_stat_replication). Следующие ведомые серверы в этом списке являются потенциальными синхронными серверами. Если любой из текущих синхронных ведомых серверов отключается по какой-либо причине, он немедленно заменяется другим, следующим по приоритету. Таким образом, указание нескольких имён ведомых серверов позволяет обеспечить очень высокую степень доступности.Этот параметр принимает список ведомых серверов в одной из следующих форм:
число_синхронных(имя_ведомого[, ...] )имя_ведомого[, ...]здесь
число_синхронных— число синхронных ведомых серверов, от которых необходимо дожидаться ответов для завершения транзакций, аимя_ведомого— имя ведомого сервера. Например, со значением3 (s1, s2, s3, s4)фиксирование транзакций будет завершаться только после получения записей WAL тремя выбранными по приоритету ведомыми серверами из спискаs1,s2,s3иs4.Вторая форма использовалась в Postgres Pro до версии 9.6 и по-прежнему поддерживается. По сути она равнозначна первой с
числом_синхронных, равным 1. Например,1 (s1, s2)иs1, s2действуют одинаково: в качестве синхронного ведомого выбирается либоs1, либоs2.В качестве имени ведомого сервера в данном случае указывается значение параметра
application_name, задаваемое в строке подключенияprimary_conninfoна ведомом сервере, принимающем WAL. Уникальность этих имён не контролируется. В случае дублирования имён более приоритетным синхронным ведомым будет считаться один, хотя какой именно, не определено. Специальному указанию*соответствует любое имя приложения (application_name), включая имя приложения по умолчанию (walreceiver).Примечание
Каждое
имя_ведомогодолжно задаваться в виде допустимого идентификатора SQL, кроме*. При необходимости его можно заключать в кавычки. Но заметьте, что идентификаторыимя_ведомогосравниваются с именами приложений без учёта регистра, независимо от того, заключены ли они в кавычки или нет.Если имена синхронных ведомых серверов не определены, синхронная репликация не включается и фиксируемые транзакции не будут ждать репликации. Это поведение по умолчанию. Даже когда синхронная репликация включена, для отдельных транзакций можно отключить ожидание репликации, задав для параметра synchronous_commit значение
localилиoff.Задать этот параметр можно только в
postgresql.confили в командной строке при запуске сервера.vacuum_defer_cleanup_age(integer)Задаёт число транзакций, на которое будет отложена очистка старых версий строк при
VACUUMи изменениях HOT. По умолчанию это число равно нулю, то есть старые версии строк могут удаляться сразу, как только перестанут быть видимыми в открытых транзакциях. Это значение можно сделать ненулевым на ведущем сервере, работающим с серверами горячего резерва, как описано в Разделе 25.5. В результате увеличится время, в течение которого будут успешно выполняться запросы на ведомом сервере без конфликтов из-за ранней очистки строк. Однако ввиду того, что эта отсрочка определяется числом записывающих транзакций, выполняющихся на ведущем сервере, сложно предсказать, каким будет дополнительное время отсрочки на ведомом сервере. Задать этот параметр можно только вpostgresql.confили в командной строке при запуске сервера.В качестве альтернативы этому параметру можно также рассмотреть
hot_standby_feedbackна ведомом сервере.Этот параметр не предотвращает очистку старых строк, которые достигли возраста, заданного параметром
old_snapshot_threshold.
18.6.3. Ведомые серверы
Эти параметры управляют поведением ведомого сервера, который будет получать данные репликации. На ведущем сервере они не играют никакой роли.
hot_standby(boolean)Определяет, можно ли будет подключаться к серверу и выполнять запросы в процессе восстановления, как описано в Разделе 25.5. Значение по умолчанию —
off(подключения не разрешаются). Задать этот параметр можно только при запуске сервера. Данный параметр играет роль только в режиме ведомого сервера или при восстановлении архива.max_standby_archive_delay(integer)В режиме горячего резерва этот параметр определяет, как долго должен ждать ведомый сервер, прежде чем отменять запросы, конфликтующие с очередными изменениями в WAL, как описано в Подразделе 25.5.2. Задержка
max_standby_archive_delayприменяется при обработке данных WAL, считываемых из архива (не текущих данных). Значение этого параметра задаётся в миллисекундах (если явно не указаны другие единицы) и по умолчанию равно 30 секундам. При значении, равном -1, ведомый может ждать завершения конфликтующих запросов неограниченное время. Задать этот параметр можно только вpostgresql.confили в командной строке при запуске сервера.Заметьте, что параметр
max_standby_archive_delayопределяет не максимальное время, которое отводится для выполнения каждого запроса, а максимальное общее время, за которое должны быть применены изменения из одного сегмента WAL. Таким образом, если один запрос привёл к значительной задержке при обработке сегмента WAL, остальным конфликтующим запросам будет отведено гораздо меньше времени.max_standby_streaming_delay(integer)В режиме горячего резерва этот параметр определяет, как долго должен ждать ведомый сервер, прежде чем отменять запросы, конфликтующие с очередными изменениями в WAL, как описано в Подразделе 25.5.2. Задержка
max_standby_streaming_delayприменяется при обработке данных WAL, поступающих при потоковой репликации. Значение этого параметра задаётся в миллисекундах (если явно не указаны другие единицы) и по умолчанию равно 30 секундам. При значении, равном -1, ведомый может ждать завершения конфликтующих запросов неограниченное время. Задать этот параметр можно только вpostgresql.confили в командной строке при запуске сервера.Заметьте, что параметр
max_standby_streaming_delayопределяет не максимальное время, которое отводится для выполнения каждого запроса, а максимальное общее время, за которое должны быть применены изменения из WAL после получения от главного сервера. Таким образом, если один запрос привёл к значительной задержке, остальным конфликтующим запросам будет отводиться гораздо меньше времени, пока резервный сервер не догонит главный.wal_receiver_status_interval(integer)Определяет минимальную частоту, с которой процесс, принимающий WAL на ведомом сервере, будет сообщать о состоянии репликации ведущему или вышестоящему ведомому, где это состояние можно наблюдать в представлении
pg_stat_replication. В этом сообщении передаются следующие позиции в журнале предзаписи: позиция изменений записанных, изменений, сохранённых на диске, и изменений применённых. Значение параметра задаётся в секундах и определяет максимальный интервал между сообщениями. Сообщения о состоянии передаются при каждом продвижении позиций записанных или сохранённых на диске изменений, но с промежутком не больше, чем заданный этим параметром. Таким образом, последняя переданная позиция применённых изменений может немного отставать от фактической в текущий момент. При нулевом значении этого параметра передача состояния полностью отключается. Задать этот параметр можно только вpostgresql.confили в командной строке при запуске сервера. По умолчанию его значение равно 10 секундам.hot_standby_feedback(boolean)Определяет, будет ли сервер горячего резерва сообщать ведущему или вышестоящему ведомому о запросах, которые он выполняет в данный момент. Это позволяет исключить необходимость отмены запросов, вызванную очисткой записей, но при некоторых типах нагрузки это может приводить к раздуванию базы данных на ведущем сервере. Эти сообщения о запросах будут отправляться не чаще, чем раз в интервал, задаваемый параметром
wal_receiver_status_interval. Значение данного параметра по умолчанию —off. Задать этот параметр можно только вpostgresql.confили в командной строке при запуске сервера.Если используется каскадная репликация, сообщения о запросах передаются выше, пока в итоге не достигнут ведущего сервера. На промежуточных серверах эта информация больше никак не задействуется.
Этот параметр не переопределяет поведение
old_snapshot_threshold, установленное на ведущем сервере; снимок на ведомом сервере, имеющий возраст больше заданного указанным параметром на ведущем, может стать недействительным, что приведёт к отмене транзакций на ведомом. Это объясняется тем, что предназначениеold_snapshot_thresholdзаключается в указании абсолютного ограничения времени, в течение которого могут накапливаться мёртвые строки, которое иначе могло бы нарушаться из-за конфигурации ведомого.wal_receiver_timeout(integer)Задаёт период времени (в миллисекундах), по истечении которого прерываются неактивные соединения репликации. Это помогает принимающему ведомому серверу обнаружить сбой ведущего или разрыв сети. При значении, равном нулю, тайм-аут отключается. Задать этот параметр можно только в
postgresql.confили в командной строке при запуске сервера. Значение по умолчанию — 60 секунд.wal_retrieve_retry_interval(integer)Определяет, сколько ведомый сервер должен ждать поступления данных WAL из любых источников (потоковая репликация, локальный
pg_xlogили архив WAL), прежде чем повторять попытку получения WAL. Задать этот параметр можно только вpostgresql.confили в командной строке сервера. Значение по умолчанию — 5 секунд. Если единицы не задаются, подразумеваются миллисекунды.Этот параметр полезен в конфигурациях, когда для узла в схеме восстановления нужно регулировать время ожидания новых данных WAL. Например, при восстановлении архива можно ускорить реакцию на появление нового файла WAL, уменьшив значение этого параметра. В системе с низкой активностью WAL увеличение этого параметра приведёт к сокращению числа запросов, необходимых для отслеживания архивов WAL, что может быть полезно в облачных окружениях, где учитывается число обращений к инфраструктуре.
18.6. Replication
These settings control the behavior of the built-in streaming replication feature (see Section 25.2.5). Servers will be either a Master or a Standby server. Masters can send data, while Standby(s) are always receivers of replicated data. When cascading replication (see Section 25.2.7) is used, Standby server(s) can also be senders, as well as receivers. Parameters are mainly for Sending and Standby servers, though some parameters have meaning only on the Master server. Settings may vary across the cluster without problems if that is required.
18.6.1. Sending Server(s)
These parameters can be set on any server that is to send replication data to one or more standby servers. The master is always a sending server, so these parameters must always be set on the master. The role and meaning of these parameters does not change after a standby becomes the master.
max_wal_senders(integer)Specifies the maximum number of concurrent connections from standby servers or streaming base backup clients (i.e., the maximum number of simultaneously running WAL sender processes). The default is zero, meaning replication is disabled. WAL sender processes count towards the total number of connections, so the parameter cannot be set higher than max_connections. Abrupt streaming client disconnection might cause an orphaned connection slot until a timeout is reached, so this parameter should be set slightly higher than the maximum number of expected clients so disconnected clients can immediately reconnect. This parameter can only be set at server start.
wal_levelmust be set toreplicaor higher to allow connections from standby servers.max_replication_slots(integer)Specifies the maximum number of replication slots (see Section 25.2.6) that the server can support. The default is zero. This parameter can only be set at server start.
wal_levelmust be set toreplicaor higher to allow replication slots to be used. Setting it to a lower value than the number of currently existing replication slots will prevent the server from starting.wal_keep_segments(integer)Specifies the minimum number of past log file segments kept in the
pg_xlogdirectory, in case a standby server needs to fetch them for streaming replication. Each segment is normally 16 megabytes. If a standby server connected to the sending server falls behind by more thanwal_keep_segmentssegments, the sending server might remove a WAL segment still needed by the standby, in which case the replication connection will be terminated. Downstream connections will also eventually fail as a result. (However, the standby server can recover by fetching the segment from archive, if WAL archiving is in use.)This sets only the minimum number of segments retained in
pg_xlog; the system might need to retain more segments for WAL archival or to recover from a checkpoint. Ifwal_keep_segmentsis zero (the default), the system doesn't keep any extra segments for standby purposes, so the number of old WAL segments available to standby servers is a function of the location of the previous checkpoint and status of WAL archiving. This parameter can only be set in thepostgresql.conffile or on the server command line.wal_sender_timeout(integer)Terminate replication connections that are inactive longer than the specified number of milliseconds. This is useful for the sending server to detect a standby crash or network outage. A value of zero disables the timeout mechanism. This parameter can only be set in the
postgresql.conffile or on the server command line. The default value is 60 seconds.track_commit_timestamp(bool)Record commit time of transactions. This parameter can only be set in
postgresql.conffile or on the server command line. The default value isoff.
18.6.2. Master Server
These parameters can be set on the master/primary server that is to send replication data to one or more standby servers. Note that in addition to these parameters, wal_level must be set appropriately on the master server, and optionally WAL archiving can be enabled as well (see Section 18.5.3). The values of these parameters on standby servers are irrelevant, although you may wish to set them there in preparation for the possibility of a standby becoming the master.
synchronous_standby_names(string)Specifies a list of standby servers that can support synchronous replication, as described in Section 25.2.8. There will be one or more active synchronous standbys; transactions waiting for commit will be allowed to proceed after these standby servers confirm receipt of their data. The synchronous standbys will be those whose names appear earlier in this list, and that are both currently connected and streaming data in real-time (as shown by a state of
streamingin thepg_stat_replicationview). Other standby servers appearing later in this list represent potential synchronous standbys. If any of the current synchronous standbys disconnects for whatever reason, it will be replaced immediately with the next-highest-priority standby. Specifying more than one standby name can allow very high availability.This parameter specifies a list of standby servers using either of the following syntaxes:
num_sync(standby_name[, ...] )standby_name[, ...]where
num_syncis the number of synchronous standbys that transactions need to wait for replies from, andstandby_nameis the name of a standby server. For example, a setting of3 (s1, s2, s3, s4)makes transaction commits wait until their WAL records are received by three higher-priority standbys chosen from standby serverss1,s2,s3ands4.The second syntax was used before Postgres Pro version 9.6 and is still supported. It's the same as the first syntax with
num_syncequal to 1. For example,1 (s1, s2)ands1, s2have the same meaning: eithers1ors2is chosen as a synchronous standby.The name of a standby server for this purpose is the
application_namesetting of the standby, as set in theprimary_conninfoof the standby's WAL receiver. There is no mechanism to enforce uniqueness. In case of duplicates one of the matching standbys will be considered as higher priority, though exactly which one is indeterminate. The special entry*matches anyapplication_name, including the default application name ofwalreceiver.Note
Each
standby_nameshould have the form of a valid SQL identifier, unless it is*. You can use double-quoting if necessary. But note thatstandby_names are compared to standby application names case-insensitively, whether double-quoted or not.If no synchronous standby names are specified here, then synchronous replication is not enabled and transaction commits will not wait for replication. This is the default configuration. Even when synchronous replication is enabled, individual transactions can be configured not to wait for replication by setting the synchronous_commit parameter to
localoroff.This parameter can only be set in the
postgresql.conffile or on the server command line.vacuum_defer_cleanup_age(integer)Specifies the number of transactions by which
VACUUMand HOT updates will defer cleanup of dead row versions. The default is zero transactions, meaning that dead row versions can be removed as soon as possible, that is, as soon as they are no longer visible to any open transaction. You may wish to set this to a non-zero value on a primary server that is supporting hot standby servers, as described in Section 25.5. This allows more time for queries on the standby to complete without incurring conflicts due to early cleanup of rows. However, since the value is measured in terms of number of write transactions occurring on the primary server, it is difficult to predict just how much additional grace time will be made available to standby queries. This parameter can only be set in thepostgresql.conffile or on the server command line.You should also consider setting
hot_standby_feedbackon standby server(s) as an alternative to using this parameter.This does not prevent cleanup of dead rows which have reached the age specified by
old_snapshot_threshold.
18.6.3. Standby Servers
These settings control the behavior of a standby server that is to receive replication data. Their values on the master server are irrelevant.
hot_standby(boolean)Specifies whether or not you can connect and run queries during recovery, as described in Section 25.5. The default value is
off. This parameter can only be set at server start. It only has effect during archive recovery or in standby mode.max_standby_archive_delay(integer)When Hot Standby is active, this parameter determines how long the standby server should wait before canceling standby queries that conflict with about-to-be-applied WAL entries, as described in Section 25.5.2.
max_standby_archive_delayapplies when WAL data is being read from WAL archive (and is therefore not current). The default is 30 seconds. Units are milliseconds if not specified. A value of -1 allows the standby to wait forever for conflicting queries to complete. This parameter can only be set in thepostgresql.conffile or on the server command line.Note that
max_standby_archive_delayis not the same as the maximum length of time a query can run before cancellation; rather it is the maximum total time allowed to apply any one WAL segment's data. Thus, if one query has resulted in significant delay earlier in the WAL segment, subsequent conflicting queries will have much less grace time.max_standby_streaming_delay(integer)When Hot Standby is active, this parameter determines how long the standby server should wait before canceling standby queries that conflict with about-to-be-applied WAL entries, as described in Section 25.5.2.
max_standby_streaming_delayapplies when WAL data is being received via streaming replication. The default is 30 seconds. Units are milliseconds if not specified. A value of -1 allows the standby to wait forever for conflicting queries to complete. This parameter can only be set in thepostgresql.conffile or on the server command line.Note that
max_standby_streaming_delayis not the same as the maximum length of time a query can run before cancellation; rather it is the maximum total time allowed to apply WAL data once it has been received from the primary server. Thus, if one query has resulted in significant delay, subsequent conflicting queries will have much less grace time until the standby server has caught up again.wal_receiver_status_interval(integer)Specifies the minimum frequency for the WAL receiver process on the standby to send information about replication progress to the primary or upstream standby, where it can be seen using the
pg_stat_replicationview. The standby will report the last transaction log position it has written, the last position it has flushed to disk, and the last position it has applied. This parameter's value is the maximum interval, in seconds, between reports. Updates are sent each time the write or flush positions change, or at least as often as specified by this parameter. Thus, the apply position may lag slightly behind the true position. Setting this parameter to zero disables status updates completely. This parameter can only be set in thepostgresql.conffile or on the server command line. The default value is 10 seconds.hot_standby_feedback(boolean)Specifies whether or not a hot standby will send feedback to the primary or upstream standby about queries currently executing on the standby. This parameter can be used to eliminate query cancels caused by cleanup records, but can cause database bloat on the primary for some workloads. Feedback messages will not be sent more frequently than once per
wal_receiver_status_interval. The default value isoff. This parameter can only be set in thepostgresql.conffile or on the server command line.If cascaded replication is in use the feedback is passed upstream until it eventually reaches the primary. Standbys make no other use of feedback they receive other than to pass upstream.
This setting does not override the behavior of
old_snapshot_thresholdon the primary; a snapshot on the standby which exceeds the primary's age threshold can become invalid, resulting in cancellation of transactions on the standby. This is becauseold_snapshot_thresholdis intended to provide an absolute limit on the time which dead rows can contribute to bloat, which would otherwise be violated because of the configuration of a standby.wal_receiver_timeout(integer)Terminate replication connections that are inactive longer than the specified number of milliseconds. This is useful for the receiving standby server to detect a primary node crash or network outage. A value of zero disables the timeout mechanism. This parameter can only be set in the
postgresql.conffile or on the server command line. The default value is 60 seconds.wal_retrieve_retry_interval(integer)Specify how long the standby server should wait when WAL data is not available from any sources (streaming replication, local
pg_xlogor WAL archive) before retrying to retrieve WAL data. This parameter can only be set in thepostgresql.conffile or on the server command line. The default value is 5 seconds. Units are milliseconds if not specified.This parameter is useful in configurations where a node in recovery needs to control the amount of time to wait for new WAL data to be available. For example, in archive recovery, it is possible to make the recovery more responsive in the detection of a new WAL log file by reducing the value of this parameter. On a system with low WAL activity, increasing it reduces the amount of requests necessary to access WAL archives, something useful for example in cloud environments where the amount of times an infrastructure is accessed is taken into account.