Commit 91ad8b41 authored by Peter Eisentraut's avatar Peter Eisentraut

doc: Document commands that cannot be run in a transaction block

Mainly covering the new CREATE SUBSCRIPTION and DROP SUBSCRIPTION, but
ALTER DATABASE SET TABLESPACE was also missing.
parent 8d926029
...@@ -164,6 +164,10 @@ ALTER DATABASE <replaceable class="PARAMETER">name</replaceable> RESET ALL ...@@ -164,6 +164,10 @@ ALTER DATABASE <replaceable class="PARAMETER">name</replaceable> RESET ALL
<para> <para>
The new default tablespace of the database. The new default tablespace of the database.
</para> </para>
<para>
This form of the command cannot be executed inside a transaction block.
</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
......
...@@ -48,11 +48,6 @@ CREATE SUBSCRIPTION <replaceable class="PARAMETER">subscription_name</replaceabl ...@@ -48,11 +48,6 @@ CREATE SUBSCRIPTION <replaceable class="PARAMETER">subscription_name</replaceabl
subscription at the commit of the transaction where this command is run. subscription at the commit of the transaction where this command is run.
</para> </para>
<para>
<command>CREATE SUBSCRIPTION</command> cannot be executed inside a
transaction block when the parameter <literal>create_slot</literal> is specified.
</para>
<para> <para>
Additional info about subscriptions and logical replication as a whole Additional info about subscriptions and logical replication as a whole
can is available at <xref linkend="logical-replication-subscription"> and can is available at <xref linkend="logical-replication-subscription"> and
...@@ -227,6 +222,11 @@ CREATE SUBSCRIPTION <replaceable class="PARAMETER">subscription_name</replaceabl ...@@ -227,6 +222,11 @@ CREATE SUBSCRIPTION <replaceable class="PARAMETER">subscription_name</replaceabl
publication instance. publication instance.
</para> </para>
<para>
When creating a replication slot (the default behavior), <command>CREATE
SUBSCRIPTION</command> cannot be executed inside a transaction block.
</para>
<para> <para>
Creating a subscription that connects to the same database cluster (for Creating a subscription that connects to the same database cluster (for
example, to replicate between databases in the same cluster or to replicate example, to replicate between databases in the same cluster or to replicate
......
...@@ -93,6 +93,11 @@ DROP SUBSCRIPTION [ IF EXISTS ] <replaceable class="parameter">name</replaceable ...@@ -93,6 +93,11 @@ DROP SUBSCRIPTION [ IF EXISTS ] <replaceable class="parameter">name</replaceable
reserve WAL and might eventually cause the disk to fill up. See reserve WAL and might eventually cause the disk to fill up. See
also <xref linkend="logical-replication-subscription-slot">. also <xref linkend="logical-replication-subscription-slot">.
</para> </para>
<para>
If a subscription is associated with a replication slot, then <command>DROP
SUBSCRIPTION</command> cannot be executed inside a transaction block.
</para>
</refsect1> </refsect1>
<refsect1> <refsect1>
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment