database/postgres
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2026-10-23 13:29:09 +03:00
Code Activity

Doc: Clarify ALTER PUBLICATION's REFRESH PUBLICATION wording.

Browse Source 
The note used a confusing "tables/except tables/schemas" slash-list,
omitted DROP from the operations requiring a subscriber refresh, and
called out "unset ALL SEQUENCES" without its symmetric "unset ALL TABLES"
case. Reword for clarity and consistency.

Author: Peter Smith <smithpb2250@gmail.com>
Reviewed-by: Amit Kapila <amit.kapila16@gmail.com>
Backpatch-through: 19
Discussion: https://postgr.es/m/CAHut+PuGKrWhVMvuFyf-wSdF-Tai_jPTz2UCSCqsYM-82ATY5w@mail.gmail.com
This commit is contained in:
Amit Kapila
2026-08-13 10:10:46 +05:30
parent ed23f7ce7f
commit dc6c9c540b
1 changed files with 7 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

13
doc/src/sgml/ref/alter_publication.sgml
View File

@@ -97,15 +97,16 @@ ALTER PUBLICATION <replaceable class="parameter">name</replaceable> RENAME TO <r
</para>
<para>
Note that adding tables/except tables/schemas to a publication that is
already subscribed to will require an
Note that adding, dropping, or setting tables or schemas in a publication
that is already subscribed to will require an
<link linkend="sql-altersubscription-params-refresh-publication">
<literal>ALTER SUBSCRIPTION ... REFRESH PUBLICATION</literal></link> action
on the subscribing side in order to become effective. Likewise altering a
publication to set <literal>ALL TABLES</literal> or to set or unset
<literal>ALL SEQUENCES</literal> also requires the subscriber to refresh the
publication. Note also that <literal>DROP TABLES IN SCHEMA</literal> will
not drop any schema tables that were specified using
publication to set <literal>ALL TABLES</literal>, to change the
<literal>EXCEPT</literal> list, or to set <literal>ALL SEQUENCES</literal>
also requires the subscriber to refresh the publication. Note also that
<literal>DROP TABLES IN SCHEMA</literal> will not drop any schema tables
that were specified using
<link linkend="sql-createpublication-params-for-table"><literal>FOR TABLE</literal></link>/
<literal>ADD TABLE</literal>.
</para>