mirrors/postgres
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Clarify the usage of max_replication_slots on the subscriber side.

Browse Source 
It was not clear in the docs that the max_replication_slots is also used
to track replication origins on the subscriber side.

Author: Paul Martinez
Reviewed-by: Amit Kapila
Backpatch-through: 10 where logical replication was introduced
Discussion: https://postgr.es/m/CACqFVBZgwCN_pHnW6dMNCrOS7tiHCw6Retf_=U2Vvj3aUSeATw@mail.gmail.com
This commit is contained in:
Amit Kapila 2021-03-03 12:01:56 +05:30
parent e527a99055
commit 8af3c233e4
2 changed files with 17 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
doc/src/sgml/config.sgml
View File

@ -4001,6 +4001,17 @@ restore_command = 'copy "C:\\server\\archivedir\\%f" "%p"' # Windows
to <literal>replica</literal> or higher to allow replication slots to to <literal>replica</literal> or higher to allow replication slots to
be used. be used.
</para> </para>
<para>
On the subscriber side, specifies how many replication origins (see
<xref linkend="replication-origins"/>) can be tracked simultaneously,
effectively limiting how many logical replication subscriptions can
be created on the server. Setting it a lower value than the current
number of tracked replication origins (reflected in
<link linkend="view-pg-replication-origin-status">pg_replication_origin_status</link>,
not <link linkend="catalog-pg-replication-origin">pg_replication_origin</link>)
will prevent the server from starting.
</para>
</listitem> </listitem>
</varlistentry> </varlistentry>

11
doc/src/sgml/logical-replication.sgml
View File

@ -603,11 +603,12 @@
<para> <para>
The subscriber also requires the <varname>max_replication_slots</varname> The subscriber also requires the <varname>max_replication_slots</varname>
to be set. In this case it should be set to at least the number of be set to configure how many replication origins can be tracked. In this
subscriptions that will be added to the subscriber, plus some reserve for case it should be set to at least the number of subscriptions that will be
table synchronization. <varname>max_logical_replication_workers</varname> added to the subscriber, plus some reserve for table synchronization.
must be set to at least the number of subscriptions, again plus some reserve <varname>max_logical_replication_workers</varname> must be set to at least
for the table synchronization. Additionally the <varname>max_worker_processes</varname> the number of subscriptions, again plus some reserve for the table
synchronization. Additionally the <varname>max_worker_processes</varname>
may need to be adjusted to accommodate for replication workers, at least may need to be adjusted to accommodate for replication workers, at least
(<varname>max_logical_replication_workers</varname> (<varname>max_logical_replication_workers</varname>
+ <literal>1</literal>). Note that some extensions and parallel queries + <literal>1</literal>). Note that some extensions and parallel queries