Introduce "REFRESH SEQUENCES" for subscriptions.
authorAmit Kapila <akapila@postgresql.org>
Thu, 23 Oct 2025 08:30:27 +0000 (08:30 +0000)
committerAmit Kapila <akapila@postgresql.org>
Thu, 23 Oct 2025 08:30:27 +0000 (08:30 +0000)
commitf0b3573c3aac6c0ea4cbc278f98178516579d370
treeaf2caa24d8562050b79ccb302d97437596b4cc55
parent6ae08d9583e9a5e951286948bdd9fcd58e67718a
Introduce "REFRESH SEQUENCES" for subscriptions.

This patch adds support for a new SQL command:
ALTER SUBSCRIPTION ... REFRESH SEQUENCES
This command updates the sequence entries present in the
pg_subscription_rel catalog table with the INIT state to trigger
resynchronization.

In addition to the new command, the following subscription commands have
been enhanced to automatically refresh sequence mappings:
ALTER SUBSCRIPTION ... REFRESH PUBLICATION
ALTER SUBSCRIPTION ... ADD PUBLICATION
ALTER SUBSCRIPTION ... DROP PUBLICATION
ALTER SUBSCRIPTION ... SET PUBLICATION

These commands will perform the following actions:
Add newly published sequences that are not yet part of the subscription.
Remove sequences that are no longer included in the publication.

This ensures that sequence replication remains aligned with the current
state of the publication on the publisher side.

Note that the actual synchronization of sequence data/values will be
handled in a subsequent patch that introduces a dedicated sequence sync
worker.

Author: Vignesh C <vignesh21@gmail.com>
Reviewed-by: Amit Kapila <amit.kapila16@gmail.com>
Reviewed-by: shveta malik <shveta.malik@gmail.com>
Reviewed-by: Masahiko Sawada <sawada.mshk@gmail.com>
Reviewed-by: Hayato Kuroda <kuroda.hayato@fujitsu.com>
Reviewed-by: Dilip Kumar <dilipbalaut@gmail.com>
Reviewed-by: Peter Smith <smithpb2250@gmail.com>
Reviewed-by: Nisha Moond <nisha.moond412@gmail.com>
Reviewed-by: Shlok Kyal <shlok.kyal.oss@gmail.com>
Reviewed-by: Chao Li <li.evan.chao@gmail.com>
Reviewed-by: Hou Zhijie <houzj.fnst@fujitsu.com>
Discussion: https://postgr.es/m/CAA4eK1LC+KJiAkSrpE_NwvNdidw9F2os7GERUeSxSKv71gXysQ@mail.gmail.com
19 files changed:
doc/src/sgml/catalogs.sgml
doc/src/sgml/ref/alter_subscription.sgml
src/backend/catalog/pg_subscription.c
src/backend/commands/subscriptioncmds.c
src/backend/executor/execReplication.c
src/backend/parser/gram.y
src/backend/replication/logical/proto.c
src/backend/replication/logical/relation.c
src/backend/replication/logical/syncutils.c
src/backend/replication/logical/tablesync.c
src/backend/replication/logical/worker.c
src/backend/replication/pgoutput/pgoutput.c
src/bin/psql/tab-complete.in.c
src/include/catalog/pg_subscription_rel.h
src/include/executor/executor.h
src/include/nodes/parsenodes.h
src/test/subscription/meson.build
src/test/subscription/t/036_sequences.pl [new file with mode: 0644]
src/tools/pgindent/typedefs.list