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

Doc: Warn about two_phase when altering a subscription's slot name.

Browse Source 
We expect the 'two_phase' and 'failover' properties to match between the
slot on the publisher and a subscription option on the subscriber.
Otherwise, the slot on the publisher may behave differently from what the
subscription's failover option says.

Author: Bertrand Drouvot
Reviewed-by: Peter Smith, Tristen Raab, Amit Kapila
Discussion: https://postgr.es/m/ZbkYrLPhH+RxpZlW@ip-10-97-1-34.eu-west-3.compute.internal
This commit is contained in:
Amit Kapila 2024-03-11 09:33:04 +05:30
parent b36fbd9f8d
commit 21e3a8bc35
1 changed files with 8 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
doc/src/sgml/ref/alter_subscription.sgml
View File

@ -235,15 +235,15 @@ ALTER SUBSCRIPTION <replaceable class="parameter">name</replaceable> RENAME TO <
<para> <para>
When altering the When altering the
<link linkend="sql-createsubscription-params-with-slot-name"><literal>slot_name</literal></link>, <link linkend="sql-createsubscription-params-with-slot-name"><literal>slot_name</literal></link>,
the <literal>failover</literal> property value of the named slot may differ from the the <literal>failover</literal> and <literal>two_phase</literal> property
values of the named slot may differ from the counterpart
<link linkend="sql-createsubscription-params-with-failover"><literal>failover</literal></link> <link linkend="sql-createsubscription-params-with-failover"><literal>failover</literal></link>
parameter specified in the subscription. When creating the slot, and <link linkend="sql-createsubscription-params-with-two-phase"><literal>two_phase</literal></link>
ensure the slot <literal>failover</literal> property matches the parameters specified in the subscription. When creating the slot, ensure
<link linkend="sql-createsubscription-params-with-failover"><literal>failover</literal></link> the slot properties <literal>failover</literal> and <literal>two_phase</literal>
parameter value of the subscription. Otherwise, the slot on the match their counterpart parameters of the subscription.
publisher may behave differently from what subscription's Otherwise, the slot on the publisher may behave differently from what these
<link linkend="sql-createsubscription-params-with-failover"><literal>failover</literal></link> subscription options say: for example, the slot on the publisher could either be
option says. The slot on the publisher could either be
synced to the standbys even when the subscription's synced to the standbys even when the subscription's
<link linkend="sql-createsubscription-params-with-failover"><literal>failover</literal></link> <link linkend="sql-createsubscription-params-with-failover"><literal>failover</literal></link>
option is disabled or could be disabled for sync option is disabled or could be disabled for sync