]> git.ipfire.org Git - thirdparty/postgresql.git/commit
Allow logical replication snapshots to be database-specific
authorÁlvaro Herrera <alvherre@kurilemu.de>
Tue, 7 Apr 2026 10:31:18 +0000 (12:31 +0200)
committerÁlvaro Herrera <alvherre@kurilemu.de>
Tue, 7 Apr 2026 10:31:18 +0000 (12:31 +0200)
commit0d3dba38c777384a9dd7dffe924355c9683a6b71
tree6279a85f5cbfb4ae69ad9e260b75a0312d88b30e
parenta3b069ef90bd3a7278920b4ea5255e019f202d5d
Allow logical replication snapshots to be database-specific

By default, the logical decoding assumes access to shared catalogs, so
the snapshot builder needs to consider cluster-wide XIDs during startup.
That in turn means that, if any transaction is already running (and has
XID assigned), the snapshot builder needs to wait for its completion, as
it does not know if that transaction performed catalog changes earlier.

A possible problem with this concept is that if REPACK (CONCURRENTLY) is
running in some database, backends running the same command in other
databases get stuck until the first one has committed. Thus only a
single backend in the cluster can run REPACK (CONCURRENTLY) at any time.
Likewise, REPACK (CONCURRENTLY) can block walsenders starting on behalf
of subscriptions throughout the cluster.

This patch adds a new option to logical replication output plugin, to
declare that it does not use shared catalogs (i.e. catalogs that can be
changed by transactions running in other databases in the cluster). In
that case, no snapshot the backend will use during the decoding needs to
contain information about transactions running in other databases. Thus
the snapshot builder only needs to wait for completion of transactions
in the current database.

Currently we only use this option in the REPACK background worker. It
could possibly be used in the plugin for logical replication too,
however that would need thorough analysis of that plugin.

Bump WAL version number, due to a new field in xl_running_xacts.

Author: Antonin Houska <ah@cybertec.at>
Reviewed-by: Álvaro Herrera <alvherre@kurilemu.de>
Discussion: https://postgr.es/m/90475.1775218118@localhost
21 files changed:
contrib/pg_visibility/pg_visibility.c
doc/src/sgml/logicaldecoding.sgml
src/backend/access/index/genam.c
src/backend/access/rmgrdesc/standbydesc.c
src/backend/access/transam/xlog.c
src/backend/access/transam/xlogfuncs.c
src/backend/postmaster/bgwriter.c
src/backend/replication/logical/decode.c
src/backend/replication/logical/logical.c
src/backend/replication/logical/snapbuild.c
src/backend/replication/pgrepack/pgrepack.c
src/backend/replication/slot.c
src/backend/storage/ipc/procarray.c
src/backend/storage/ipc/standby.c
src/include/access/xlog_internal.h
src/include/miscadmin.h
src/include/replication/output_plugin.h
src/include/replication/snapbuild.h
src/include/storage/procarray.h
src/include/storage/standby.h
src/include/storage/standbydefs.h