aboutsummaryrefslogtreecommitdiff
path: root/doc/src
diff options
context:
space:
mode:
authorTom Lane <tgl@sss.pgh.pa.us>2024-06-30 14:24:14 -0400
committerTom Lane <tgl@sss.pgh.pa.us>2024-06-30 14:24:14 -0400
commit917754557cc0002bb042341720a7ce18fe5b0a09 (patch)
treeadd6e56289d799bf85cea6059a589a9fa64ef000 /doc/src
parentb3f5ccebd79d9c7b73f4e04611cdf31fdf87420b (diff)
downloadpostgresql-917754557cc0002bb042341720a7ce18fe5b0a09.tar.gz
postgresql-917754557cc0002bb042341720a7ce18fe5b0a09.zip
Make pg_createsubscriber warn if publisher has two-phase commit enabled.
pg_createsubscriber currently always sets up logical replication with two-phase commit disabled. Improving that is not going to happen for v17. In the meantime, document the deficiency, and adjust pg_createsubscriber so that it will emit a warning if the source installation has max_prepared_transactions > 0. Hayato Kuroda (some mods by Amit Kapila and me), per complaint from Noah Misch Discussion: https://postgr.es/m/20240623062157.97.nmisch@google.com
Diffstat (limited to 'doc/src')
-rw-r--r--doc/src/sgml/ref/pg_createsubscriber.sgml11
1 files changed, 11 insertions, 0 deletions
diff --git a/doc/src/sgml/ref/pg_createsubscriber.sgml b/doc/src/sgml/ref/pg_createsubscriber.sgml
index 2ee6eee9e35..87a9d3db28e 100644
--- a/doc/src/sgml/ref/pg_createsubscriber.sgml
+++ b/doc/src/sgml/ref/pg_createsubscriber.sgml
@@ -354,6 +354,17 @@ PostgreSQL documentation
</para>
<para>
+ <application>pg_createsubscriber</application> sets up logical
+ replication with two-phase commit disabled. This means that any
+ prepared transactions will be replicated at the time
+ of <command>COMMIT PREPARED</command>, without advance preparation.
+ Once setup is complete, you can manually drop and re-create the
+ subscription(s) with
+ the <link linkend="sql-createsubscription-params-with-two-phase"><literal>two_phase</literal></link>
+ option enabled.
+ </para>
+
+ <para>
<application>pg_createsubscriber</application> changes the system
identifier using <application>pg_resetwal</application>. It would avoid
situations in which the target server might use WAL files from the source