upstream/postgresql
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2026-07-09 17:51:00 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

Doc: Clarify sequence synchronization commands.

Browse source 
Explain more accurately how REFRESH SEQUENCES differs from REFRESH
PUBLICATION in ALTER SUBSCRIPTION, and note that CREATE SUBSCRIPTION uses
copy_data = true (the default) to copy initial sequence values.

Author: Peter Smith <smithpb2250@gmail.com>
Author: Amit Kapila <amit.kapila16@gmail.com>
Backpatch-through: 19
Discussion: https://postgr.es/m/CAHut+PtFkGvZNihGRDoghWNKMfJufEpR9+thbG_8qPQ7RyVN4w@mail.gmail.com
This commit is contained in:
Amit Kapila 2026-07-09 08:01:38 +05:30
parent dff11f846c
commit 19fbb47ef6
2 changed files with 9 additions and 5 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
doc/src/sgml/logical-replication.sgml
View file

@ -1769,7 +1769,9 @@ Included in publications:
<listitem>
<para>
use <link linkend="sql-createsubscription"><command>CREATE SUBSCRIPTION</command></link>
to initially synchronize the published sequences.
with <link linkend="sql-createsubscription-params-with-copy-data">
<literal>copy_data = true</literal></link> (the default) to copy the
initial sequence values from the publisher.
</para>
</listitem>
<listitem>

10
doc/src/sgml/ref/alter_subscription.sgml
View file

@ -237,11 +237,13 @@ ALTER SUBSCRIPTION <replaceable class="parameter">name</replaceable> RENAME TO <
<para>
Re-synchronize sequence data with the publisher. Unlike
<link linkend="sql-altersubscription-params-refresh-publication">
<command>ALTER SUBSCRIPTION ... REFRESH PUBLICATION</command></link> which
only has the ability to synchronize newly added sequences,
<command>ALTER SUBSCRIPTION ... REFRESH PUBLICATION</command></link>,
which synchronizes the subscription's set of sequences with the
publication (adding new and removing dropped sequences),
<literal>REFRESH SEQUENCES</literal> will re-synchronize the sequence
data for all currently subscribed sequences. It does not add or remove
sequences from the subscription to match the publication.
data for all currently subscribed sequences without changing which
sequences are subscribed. Run <literal>REFRESH PUBLICATION</literal>
first if the publication's set of sequences has changed.
</para>
<para>
See <xref linkend="sequence-definition-mismatches"/> for