1
0
mirror of https://github.com/postgres/postgres.git synced 2025-05-29 16:21:20 +03:00

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.
This commit is contained in:
Peter Eisentraut 2017-09-22 15:01:13 -04:00
parent 1a44df007c
commit e114289e1e
3 changed files with 14 additions and 5 deletions

View File

@ -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>

View File

@ -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
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

View File

@ -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>