rdelaage
/
postgresql
mirror of https://git.postgresql.org/git/postgresql.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Doc: Make link names consistent in logical replication commands. 

Commit 536f410111 added links in the ALTER SUBSCRIPTION command page. The
link names used were slightly different from what other logical
replication commands like CREATE SUBSCRIPTION/PUBLICATION have but were
consistent with other docs. This patch changes the link names for all the
parameters to have 'params' word in the CREATE SUBSCRIPTION/PUBLICATION
pages.

Author: Peter Smith
Reviewed-by: Amit Kapila
Discussion: http://postgr.es/m/CAHut%2BPu2S4RdzYKR7H5_E7QYWyq5hB0hL4EFrYbP91Qso62jeg%40mail.gmail.com
This commit is contained in:
Amit Kapila 2023-10-30 10:46:31 +05:30
parent 1ffdc03c21
commit c4ede4fdfb
8 changed files with 64 additions and 64 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
doc/src/sgml/config.sgml
View File

@ -11702,7 +11702,7 @@ LOG: CleanUpLock: deleting: lock(0xb7acd844) id(24688,24696,0,0,0,1)
On the publisher side, <varname>debug_logical_replication_streaming</varname> On the publisher side, <varname>debug_logical_replication_streaming</varname>
allows streaming or serializing changes immediately in logical decoding. allows streaming or serializing changes immediately in logical decoding.
When set to <literal>immediate</literal>, stream each change if the When set to <literal>immediate</literal>, stream each change if the
<link linkend="sql-createsubscription-with-streaming"><literal>streaming</literal></link> <link linkend="sql-createsubscription-params-with-streaming"><literal>streaming</literal></link>
option of option of
<link linkend="sql-createsubscription"><command>CREATE SUBSCRIPTION</command></link> <link linkend="sql-createsubscription"><command>CREATE SUBSCRIPTION</command></link>
is enabled, otherwise, serialize each change. When set to is enabled, otherwise, serialize each change. When set to

34
doc/src/sgml/logical-replication.sgml
View File

@ -253,7 +253,7 @@
will be filled with the default value as specified in the definition of the will be filled with the default value as specified in the definition of the
target table. However, logical replication in binary format is more target table. However, logical replication in binary format is more
restrictive. See the restrictive. See the
<link linkend="sql-createsubscription-with-binary"><literal>binary</literal></link> <link linkend="sql-createsubscription-params-with-binary"><literal>binary</literal></link>
option of <command>CREATE SUBSCRIPTION</command> for details. option of <command>CREATE SUBSCRIPTION</command> for details.
</para> </para>
@ -371,7 +371,7 @@ INSERT 0 3
<para> <para>
Create publications for the tables. The publications <literal>pub2</literal> Create publications for the tables. The publications <literal>pub2</literal>
and <literal>pub3a</literal> disallow some and <literal>pub3a</literal> disallow some
<link linkend="sql-createpublication-with-publish"><literal>publish</literal></link> <link linkend="sql-createpublication-params-with-publish"><literal>publish</literal></link>
operations. The publication <literal>pub3b</literal> has a row filter (see operations. The publication <literal>pub3b</literal> has a row filter (see
<xref linkend="logical-replication-row-filter"/>). <xref linkend="logical-replication-row-filter"/>).
<programlisting> <programlisting>
@ -593,7 +593,7 @@ ALTER SUBSCRIPTION
<para> <para>
Example 2: Where the subscription says <literal>connect = false</literal>, Example 2: Where the subscription says <literal>connect = false</literal>,
but also specifies the but also specifies the
<link linkend="sql-createsubscription-with-slot-name"><literal>slot_name</literal></link> <link linkend="sql-createsubscription-params-with-slot-name"><literal>slot_name</literal></link>
option. option.
<itemizedlist> <itemizedlist>
<listitem> <listitem>
@ -712,7 +712,7 @@ ALTER SUBSCRIPTION
then the row is not replicated. The <literal>WHERE</literal> clause expression then the row is not replicated. The <literal>WHERE</literal> clause expression
is evaluated with the same role used for the replication connection (i.e. is evaluated with the same role used for the replication connection (i.e.
the role specified in the the role specified in the
<link linkend="sql-createsubscription-connection"><literal>CONNECTION</literal></link> <link linkend="sql-createsubscription-params-connection"><literal>CONNECTION</literal></link>
clause of the <xref linkend="sql-createsubscription"/>). Row filters have clause of the <xref linkend="sql-createsubscription"/>). Row filters have
no effect for <command>TRUNCATE</command> command. no effect for <command>TRUNCATE</command> command.
</para> </para>
@ -805,7 +805,7 @@ ALTER SUBSCRIPTION
<para> <para>
If the publication contains a partitioned table, the publication parameter If the publication contains a partitioned table, the publication parameter
<link linkend="sql-createpublication-with-publish-via-partition-root"><literal>publish_via_partition_root</literal></link> <link linkend="sql-createpublication-params-with-publish-via-partition-root"><literal>publish_via_partition_root</literal></link>
determines which row filter is used. If <literal>publish_via_partition_root</literal> determines which row filter is used. If <literal>publish_via_partition_root</literal>
is <literal>true</literal>, the <emphasis>root partitioned table's</emphasis> is <literal>true</literal>, the <emphasis>root partitioned table's</emphasis>
row filter is used. Otherwise, if <literal>publish_via_partition_root</literal> row filter is used. Otherwise, if <literal>publish_via_partition_root</literal>
@ -834,7 +834,7 @@ ALTER SUBSCRIPTION
<warning> <warning>
<para> <para>
Because initial data synchronization does not take into account the Because initial data synchronization does not take into account the
<link linkend="sql-createpublication-with-publish"><literal>publish</literal></link> <link linkend="sql-createpublication-params-with-publish"><literal>publish</literal></link>
parameter when copying existing table data, some rows may be copied that parameter when copying existing table data, some rows may be copied that
would not be replicated using DML. Refer to would not be replicated using DML. Refer to
<xref linkend="logical-replication-snapshot"/>, and see <xref linkend="logical-replication-snapshot"/>, and see
@ -858,7 +858,7 @@ ALTER SUBSCRIPTION
<para> <para>
If the subscription has several publications in which the same table has If the subscription has several publications in which the same table has
been published with different row filters (for the same been published with different row filters (for the same
<link linkend="sql-createpublication-with-publish"><literal>publish</literal></link> <link linkend="sql-createpublication-params-with-publish"><literal>publish</literal></link>
operation), those expressions get ORed together, so that rows satisfying operation), those expressions get ORed together, so that rows satisfying
<emphasis>any</emphasis> of the expressions will be replicated. This means all <emphasis>any</emphasis> of the expressions will be replicated. This means all
the other row filters for the same table become redundant if: the other row filters for the same table become redundant if:
@ -871,14 +871,14 @@ ALTER SUBSCRIPTION
<listitem> <listitem>
<para> <para>
One of the publications was created using One of the publications was created using
<link linkend="sql-createpublication-for-all-tables"><literal>FOR ALL TABLES</literal></link>. <link linkend="sql-createpublication-params-for-all-tables"><literal>FOR ALL TABLES</literal></link>.
This clause does not allow row filters. This clause does not allow row filters.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
One of the publications was created using One of the publications was created using
<link linkend="sql-createpublication-for-tables-in-schema"><literal>FOR TABLES IN SCHEMA</literal></link> <link linkend="sql-createpublication-params-for-tables-in-schema"><literal>FOR TABLES IN SCHEMA</literal></link>
and the table belongs to the referred schema. This clause does not allow and the table belongs to the referred schema. This clause does not allow
row filters. row filters.
</para> </para>
@ -1145,7 +1145,7 @@ test_sub=# SELECT * FROM t1;
<para> <para>
The following examples show how the publication parameter The following examples show how the publication parameter
<link linkend="sql-createpublication-with-publish-via-partition-root"><literal>publish_via_partition_root</literal></link> <link linkend="sql-createpublication-params-with-publish-via-partition-root"><literal>publish_via_partition_root</literal></link>
determines whether the row filter of the parent or child table will be used determines whether the row filter of the parent or child table will be used
in the case of partitioned tables. in the case of partitioned tables.
</para> </para>
@ -1300,13 +1300,13 @@ test_sub=# SELECT * FROM child ORDER BY a;
<para> <para>
Specifying a column list when the publication also publishes Specifying a column list when the publication also publishes
<link linkend="sql-createpublication-for-tables-in-schema"><literal>FOR TABLES IN SCHEMA</literal></link> <link linkend="sql-createpublication-params-for-tables-in-schema"><literal>FOR TABLES IN SCHEMA</literal></link>
is not supported. is not supported.
</para> </para>
<para> <para>
For partitioned tables, the publication parameter For partitioned tables, the publication parameter
<link linkend="sql-createpublication-with-publish-via-partition-root"><literal>publish_via_partition_root</literal></link> <link linkend="sql-createpublication-params-with-publish-via-partition-root"><literal>publish_via_partition_root</literal></link>
determines which column list is used. If <literal>publish_via_partition_root</literal> determines which column list is used. If <literal>publish_via_partition_root</literal>
is <literal>true</literal>, the root partitioned table's column list is is <literal>true</literal>, the root partitioned table's column list is
used. Otherwise, if <literal>publish_via_partition_root</literal> is used. Otherwise, if <literal>publish_via_partition_root</literal> is
@ -1518,7 +1518,7 @@ CONTEXT: processing remote data for replication origin "pg_16395" during "INSER
either by <link linkend="sql-altersubscription-params-disable"> either by <link linkend="sql-altersubscription-params-disable">
<command>ALTER SUBSCRIPTION ... DISABLE</command></link> or, the <command>ALTER SUBSCRIPTION ... DISABLE</command></link> or, the
subscription can be used with the subscription can be used with the
<link linkend="sql-createsubscription-with-disable-on-error"><literal>disable_on_error</literal></link> <link linkend="sql-createsubscription-params-with-disable-on-error"><literal>disable_on_error</literal></link>
option. Then, you can use <function>pg_replication_origin_advance()</function> option. Then, you can use <function>pg_replication_origin_advance()</function>
function with the <parameter>node_name</parameter> (i.e., <literal>pg_16395</literal>) function with the <parameter>node_name</parameter> (i.e., <literal>pg_16395</literal>)
and the next LSN of the finish LSN (i.e., 0/14C0379). The current position of and the next LSN of the finish LSN (i.e., 0/14C0379). The current position of
@ -1531,7 +1531,7 @@ CONTEXT: processing remote data for replication origin "pg_16395" during "INSER
<para> <para>
When the When the
<link linkend="sql-createsubscription-with-streaming"><literal>streaming</literal></link> <link linkend="sql-createsubscription-params-with-streaming"><literal>streaming</literal></link>
mode is <literal>parallel</literal>, the finish LSN of failed transactions mode is <literal>parallel</literal>, the finish LSN of failed transactions
may not be logged. In that case, it may be necessary to change the streaming may not be logged. In that case, it may be necessary to change the streaming
mode to <literal>on</literal> or <literal>off</literal> and cause the same mode to <literal>on</literal> or <literal>off</literal> and cause the same
@ -1624,7 +1624,7 @@ CONTEXT: processing remote data for replication origin "pg_16395" during "INSER
using the identity and schema of the partitioned root table instead of using the identity and schema of the partitioned root table instead of
that of the individual leaf partitions in which the changes actually that of the individual leaf partitions in which the changes actually
originate (see originate (see
<link linkend="sql-createpublication-with-publish-via-partition-root"><literal>publish_via_partition_root</literal></link> <link linkend="sql-createpublication-params-with-publish-via-partition-root"><literal>publish_via_partition_root</literal></link>
parameter of <command>CREATE PUBLICATION</command>). parameter of <command>CREATE PUBLICATION</command>).
</para> </para>
</listitem> </listitem>
@ -1709,7 +1709,7 @@ CONTEXT: processing remote data for replication origin "pg_16395" during "INSER
<note> <note>
<para> <para>
The publication The publication
<link linkend="sql-createpublication-with-publish"><literal>publish</literal></link> <link linkend="sql-createpublication-params-with-publish"><literal>publish</literal></link>
parameter only affects what DML operations will be replicated. The parameter only affects what DML operations will be replicated. The
initial data synchronization does not take this parameter into account initial data synchronization does not take this parameter into account
when copying the existing table data. when copying the existing table data.
@ -1743,7 +1743,7 @@ CONTEXT: processing remote data for replication origin "pg_16395" during "INSER
zero rows in this view. If the initial data synchronization of any zero rows in this view. If the initial data synchronization of any
table is in progress, there will be additional workers for the tables table is in progress, there will be additional workers for the tables
being synchronized. Moreover, if the being synchronized. Moreover, if the
<link linkend="sql-createsubscription-with-streaming"><literal>streaming</literal></link> <link linkend="sql-createsubscription-params-with-streaming"><literal>streaming</literal></link>
transaction is applied in parallel, there may be additional parallel apply transaction is applied in parallel, there may be additional parallel apply
workers. workers.
</para> </para>

6
doc/src/sgml/ref/alter_publication.sgml
View File

@ -56,7 +56,7 @@ ALTER PUBLICATION <replaceable class="parameter">name</replaceable> RENAME TO <r
subscribing side in order to become effective. Note also that subscribing side in order to become effective. Note also that
<literal>DROP TABLES IN SCHEMA</literal> will not drop any schema tables <literal>DROP TABLES IN SCHEMA</literal> will not drop any schema tables
that were specified using that were specified using
<link linkend="sql-createpublication-for-table"><literal>FOR TABLE</literal></link>/ <link linkend="sql-createpublication-params-for-table"><literal>FOR TABLE</literal></link>/
<literal>ADD TABLE</literal>, and the combination of <literal>DROP</literal> <literal>ADD TABLE</literal>, and the combination of <literal>DROP</literal>
with a <literal>WHERE</literal> clause is not allowed. with a <literal>WHERE</literal> clause is not allowed.
</para> </para>
@ -82,8 +82,8 @@ ALTER PUBLICATION <replaceable class="parameter">name</replaceable> RENAME TO <r
new owning role, and that role must have <literal>CREATE</literal> new owning role, and that role must have <literal>CREATE</literal>
privilege on the database. privilege on the database.
Also, the new owner of a Also, the new owner of a
<link linkend="sql-createpublication-for-all-tables"><literal>FOR ALL TABLES</literal></link> <link linkend="sql-createpublication-params-for-all-tables"><literal>FOR ALL TABLES</literal></link>
or <link linkend="sql-createpublication-for-tables-in-schema"><literal>FOR TABLES IN SCHEMA</literal></link> or <link linkend="sql-createpublication-params-for-tables-in-schema"><literal>FOR TABLES IN SCHEMA</literal></link>
publication must be a superuser. However, a superuser can publication must be a superuser. However, a superuser can
change the ownership of a publication regardless of these restrictions. change the ownership of a publication regardless of these restrictions.
</para> </para>

26
doc/src/sgml/ref/alter_subscription.sgml
View File

@ -72,9 +72,9 @@ ALTER SUBSCRIPTION <replaceable class="parameter">name</replaceable> RENAME TO <
executed inside a transaction block. executed inside a transaction block.
These commands also cannot be executed when the subscription has These commands also cannot be executed when the subscription has
<link linkend="sql-createsubscription-with-two-phase"><literal>two_phase</literal></link> <link linkend="sql-createsubscription-params-with-two-phase"><literal>two_phase</literal></link>
commit enabled, unless commit enabled, unless
<link linkend="sql-createsubscription-with-copy-data"><literal>copy_data</literal></link> <link linkend="sql-createsubscription-params-with-copy-data"><literal>copy_data</literal></link>
is <literal>false</literal>. See column <structfield>subtwophasestate</structfield> is <literal>false</literal>. See column <structfield>subtwophasestate</structfield>
of <link linkend="catalog-pg-subscription"><structname>pg_subscription</structname></link> of <link linkend="catalog-pg-subscription"><structname>pg_subscription</structname></link>
to know the actual two-phase state. to know the actual two-phase state.
@ -178,12 +178,12 @@ ALTER SUBSCRIPTION <replaceable class="parameter">name</replaceable> RENAME TO <
<para> <para>
See <xref linkend="sql-createsubscription-notes"/> for details of See <xref linkend="sql-createsubscription-notes"/> for details of
how <literal>copy_data = true</literal> can interact with the how <literal>copy_data = true</literal> can interact with the
<link linkend="sql-createsubscription-with-origin"><literal>origin</literal></link> <link linkend="sql-createsubscription-params-with-origin"><literal>origin</literal></link>
parameter. parameter.
</para> </para>
<para> <para>
See the See the
<link linkend="sql-createsubscription-with-binary"><literal>binary</literal></link> <link linkend="sql-createsubscription-params-with-binary"><literal>binary</literal></link>
parameter of <command>CREATE SUBSCRIPTION</command> for details about parameter of <command>CREATE SUBSCRIPTION</command> for details about
copying pre-existing data in binary format. copying pre-existing data in binary format.
</para> </para>
@ -220,14 +220,14 @@ ALTER SUBSCRIPTION <replaceable class="parameter">name</replaceable> RENAME TO <
This clause alters parameters originally set by This clause alters parameters originally set by
<xref linkend="sql-createsubscription"/>. See there for more <xref linkend="sql-createsubscription"/>. See there for more
information. The parameters that can be altered are information. The parameters that can be altered are
<link linkend="sql-createsubscription-with-slot-name"><literal>slot_name</literal></link>, <link linkend="sql-createsubscription-params-with-slot-name"><literal>slot_name</literal></link>,
<link linkend="sql-createsubscription-with-synchronous-commit"><literal>synchronous_commit</literal></link>, <link linkend="sql-createsubscription-params-with-synchronous-commit"><literal>synchronous_commit</literal></link>,
<link linkend="sql-createsubscription-with-binary"><literal>binary</literal></link>, <link linkend="sql-createsubscription-params-with-binary"><literal>binary</literal></link>,
<link linkend="sql-createsubscription-with-streaming"><literal>streaming</literal></link>, <link linkend="sql-createsubscription-params-with-streaming"><literal>streaming</literal></link>,
<link linkend="sql-createsubscription-with-disable-on-error"><literal>disable_on_error</literal></link>, <link linkend="sql-createsubscription-params-with-disable-on-error"><literal>disable_on_error</literal></link>,
<link linkend="sql-createsubscription-with-password-required"><literal>password_required</literal></link>, <link linkend="sql-createsubscription-params-with-password-required"><literal>password_required</literal></link>,
<link linkend="sql-createsubscription-with-run-as-owner"><literal>run_as_owner</literal></link>, and <link linkend="sql-createsubscription-params-with-run-as-owner"><literal>run_as_owner</literal></link>, and
<link linkend="sql-createsubscription-with-origin"><literal>origin</literal></link>. <link linkend="sql-createsubscription-params-with-origin"><literal>origin</literal></link>.
Only a superuser can set <literal>password_required = false</literal>. Only a superuser can set <literal>password_required = false</literal>.
</para> </para>
</listitem> </listitem>
@ -243,7 +243,7 @@ ALTER SUBSCRIPTION <replaceable class="parameter">name</replaceable> RENAME TO <
the logical replication worker skips all data modification changes within the logical replication worker skips all data modification changes within
the transaction. This option has no effect on the transactions that are the transaction. This option has no effect on the transactions that are
already prepared by enabling already prepared by enabling
<link linkend="sql-createsubscription-with-two-phase"><literal>two_phase</literal></link> <link linkend="sql-createsubscription-params-with-two-phase"><literal>two_phase</literal></link>
on the subscriber. on the subscriber.
After the logical replication worker successfully skips the transaction or After the logical replication worker successfully skips the transaction or
finishes a transaction, the LSN (stored in finishes a transaction, the LSN (stored in

14
doc/src/sgml/ref/create_publication.sgml
View File

@ -54,7 +54,7 @@ CREATE PUBLICATION <replaceable class="parameter">name</replaceable>
<title>Parameters</title> <title>Parameters</title>
<variablelist> <variablelist>
<varlistentry id="sql-createpublication-name"> <varlistentry id="sql-createpublication-params-name">
<term><replaceable class="parameter">name</replaceable></term> <term><replaceable class="parameter">name</replaceable></term>
<listitem> <listitem>
<para> <para>
@ -63,7 +63,7 @@ CREATE PUBLICATION <replaceable class="parameter">name</replaceable>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="sql-createpublication-for-table"> <varlistentry id="sql-createpublication-params-for-table">
<term><literal>FOR TABLE</literal></term> <term><literal>FOR TABLE</literal></term>
<listitem> <listitem>
<para> <para>
@ -117,7 +117,7 @@ CREATE PUBLICATION <replaceable class="parameter">name</replaceable>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="sql-createpublication-for-all-tables"> <varlistentry id="sql-createpublication-params-for-all-tables">
<term><literal>FOR ALL TABLES</literal></term> <term><literal>FOR ALL TABLES</literal></term>
<listitem> <listitem>
<para> <para>
@ -127,7 +127,7 @@ CREATE PUBLICATION <replaceable class="parameter">name</replaceable>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="sql-createpublication-for-tables-in-schema"> <varlistentry id="sql-createpublication-params-for-tables-in-schema">
<term><literal>FOR TABLES IN SCHEMA</literal></term> <term><literal>FOR TABLES IN SCHEMA</literal></term>
<listitem> <listitem>
<para> <para>
@ -158,7 +158,7 @@ CREATE PUBLICATION <replaceable class="parameter">name</replaceable>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="sql-createpublication-with"> <varlistentry id="sql-createpublication-params-with">
<term><literal>WITH ( <replaceable class="parameter">publication_parameter</replaceable> [= <replaceable class="parameter">value</replaceable>] [, ... ] )</literal></term> <term><literal>WITH ( <replaceable class="parameter">publication_parameter</replaceable> [= <replaceable class="parameter">value</replaceable>] [, ... ] )</literal></term>
<listitem> <listitem>
<para> <para>
@ -166,7 +166,7 @@ CREATE PUBLICATION <replaceable class="parameter">name</replaceable>
following parameters are supported: following parameters are supported:
<variablelist> <variablelist>
<varlistentry id="sql-createpublication-with-publish"> <varlistentry id="sql-createpublication-params-with-publish">
<term><literal>publish</literal> (<type>string</type>)</term> <term><literal>publish</literal> (<type>string</type>)</term>
<listitem> <listitem>
<para> <para>
@ -188,7 +188,7 @@ CREATE PUBLICATION <replaceable class="parameter">name</replaceable>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="sql-createpublication-with-publish-via-partition-root"> <varlistentry id="sql-createpublication-params-with-publish-via-partition-root">
<term><literal>publish_via_partition_root</literal> (<type>boolean</type>)</term> <term><literal>publish_via_partition_root</literal> (<type>boolean</type>)</term>
<listitem> <listitem>
<para> <para>

40
doc/src/sgml/ref/create_subscription.sgml
View File

@ -68,7 +68,7 @@ CREATE SUBSCRIPTION <replaceable class="parameter">subscription_name</replaceabl
<title>Parameters</title> <title>Parameters</title>
<variablelist> <variablelist>
<varlistentry id="sql-createsubscription-name"> <varlistentry id="sql-createsubscription-params-name">
<term><replaceable class="parameter">subscription_name</replaceable></term> <term><replaceable class="parameter">subscription_name</replaceable></term>
<listitem> <listitem>
<para> <para>
@ -77,7 +77,7 @@ CREATE SUBSCRIPTION <replaceable class="parameter">subscription_name</replaceabl
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="sql-createsubscription-connection"> <varlistentry id="sql-createsubscription-params-connection">
<term><literal>CONNECTION '<replaceable class="parameter">conninfo</replaceable>'</literal></term> <term><literal>CONNECTION '<replaceable class="parameter">conninfo</replaceable>'</literal></term>
<listitem> <listitem>
<para> <para>
@ -88,7 +88,7 @@ CREATE SUBSCRIPTION <replaceable class="parameter">subscription_name</replaceabl
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="sql-createsubscription-publication"> <varlistentry id="sql-createsubscription-params-publication">
<term><literal>PUBLICATION <replaceable class="parameter">publication_name</replaceable> [, ...]</literal></term> <term><literal>PUBLICATION <replaceable class="parameter">publication_name</replaceable> [, ...]</literal></term>
<listitem> <listitem>
<para> <para>
@ -97,7 +97,7 @@ CREATE SUBSCRIPTION <replaceable class="parameter">subscription_name</replaceabl
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="sql-createsubscription-with"> <varlistentry id="sql-createsubscription-params-with">
<term><literal>WITH ( <replaceable class="parameter">subscription_parameter</replaceable> [= <replaceable class="parameter">value</replaceable>] [, ... ] )</literal></term> <term><literal>WITH ( <replaceable class="parameter">subscription_parameter</replaceable> [= <replaceable class="parameter">value</replaceable>] [, ... ] )</literal></term>
<listitem> <listitem>
<para> <para>
@ -109,7 +109,7 @@ CREATE SUBSCRIPTION <replaceable class="parameter">subscription_name</replaceabl
<variablelist> <variablelist>
<varlistentry id="sql-createsubscription-with-connect"> <varlistentry id="sql-createsubscription-params-with-connect">
<term><literal>connect</literal> (<type>boolean</type>)</term> <term><literal>connect</literal> (<type>boolean</type>)</term>
<listitem> <listitem>
<para> <para>
@ -136,7 +136,7 @@ CREATE SUBSCRIPTION <replaceable class="parameter">subscription_name</replaceabl
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="sql-createsubscription-with-create-slot"> <varlistentry id="sql-createsubscription-params-with-create-slot">
<term><literal>create_slot</literal> (<type>boolean</type>)</term> <term><literal>create_slot</literal> (<type>boolean</type>)</term>
<listitem> <listitem>
<para> <para>
@ -152,7 +152,7 @@ CREATE SUBSCRIPTION <replaceable class="parameter">subscription_name</replaceabl
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="sql-createsubscription-with-enabled"> <varlistentry id="sql-createsubscription-params-with-enabled">
<term><literal>enabled</literal> (<type>boolean</type>)</term> <term><literal>enabled</literal> (<type>boolean</type>)</term>
<listitem> <listitem>
<para> <para>
@ -163,7 +163,7 @@ CREATE SUBSCRIPTION <replaceable class="parameter">subscription_name</replaceabl
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="sql-createsubscription-with-slot-name"> <varlistentry id="sql-createsubscription-params-with-slot-name">
<term><literal>slot_name</literal> (<type>string</type>)</term> <term><literal>slot_name</literal> (<type>string</type>)</term>
<listitem> <listitem>
<para> <para>
@ -192,7 +192,7 @@ CREATE SUBSCRIPTION <replaceable class="parameter">subscription_name</replaceabl
<variablelist> <variablelist>
<varlistentry id="sql-createsubscription-with-binary"> <varlistentry id="sql-createsubscription-params-with-binary">
<term><literal>binary</literal> (<type>boolean</type>)</term> <term><literal>binary</literal> (<type>boolean</type>)</term>
<listitem> <listitem>
<para> <para>
@ -229,7 +229,7 @@ CREATE SUBSCRIPTION <replaceable class="parameter">subscription_name</replaceabl
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="sql-createsubscription-with-copy-data"> <varlistentry id="sql-createsubscription-params-with-copy-data">
<term><literal>copy_data</literal> (<type>boolean</type>)</term> <term><literal>copy_data</literal> (<type>boolean</type>)</term>
<listitem> <listitem>
<para> <para>
@ -250,7 +250,7 @@ CREATE SUBSCRIPTION <replaceable class="parameter">subscription_name</replaceabl
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="sql-createsubscription-with-streaming"> <varlistentry id="sql-createsubscription-params-with-streaming">
<term><literal>streaming</literal> (<type>enum</type>)</term> <term><literal>streaming</literal> (<type>enum</type>)</term>
<listitem> <listitem>
<para> <para>
@ -278,7 +278,7 @@ CREATE SUBSCRIPTION <replaceable class="parameter">subscription_name</replaceabl
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="sql-createsubscription-with-synchronous-commit"> <varlistentry id="sql-createsubscription-params-with-synchronous-commit">
<term><literal>synchronous_commit</literal> (<type>enum</type>)</term> <term><literal>synchronous_commit</literal> (<type>enum</type>)</term>
<listitem> <listitem>
<para> <para>
@ -310,7 +310,7 @@ CREATE SUBSCRIPTION <replaceable class="parameter">subscription_name</replaceabl
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="sql-createsubscription-with-two-phase"> <varlistentry id="sql-createsubscription-params-with-two-phase">
<term><literal>two_phase</literal> (<type>boolean</type>)</term> <term><literal>two_phase</literal> (<type>boolean</type>)</term>
<listitem> <listitem>
<para> <para>
@ -341,7 +341,7 @@ CREATE SUBSCRIPTION <replaceable class="parameter">subscription_name</replaceabl
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="sql-createsubscription-with-disable-on-error"> <varlistentry id="sql-createsubscription-params-with-disable-on-error">
<term><literal>disable_on_error</literal> (<type>boolean</type>)</term> <term><literal>disable_on_error</literal> (<type>boolean</type>)</term>
<listitem> <listitem>
<para> <para>
@ -353,7 +353,7 @@ CREATE SUBSCRIPTION <replaceable class="parameter">subscription_name</replaceabl
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="sql-createsubscription-with-password-required"> <varlistentry id="sql-createsubscription-params-with-password-required">
<term><literal>password_required</literal> (<type>boolean</type>)</term> <term><literal>password_required</literal> (<type>boolean</type>)</term>
<listitem> <listitem>
<para> <para>
@ -366,7 +366,7 @@ CREATE SUBSCRIPTION <replaceable class="parameter">subscription_name</replaceabl
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="sql-createsubscription-with-run-as-owner"> <varlistentry id="sql-createsubscription-params-with-run-as-owner">
<term><literal>run_as_owner</literal> (<type>boolean</type>)</term> <term><literal>run_as_owner</literal> (<type>boolean</type>)</term>
<listitem> <listitem>
<para> <para>
@ -380,7 +380,7 @@ CREATE SUBSCRIPTION <replaceable class="parameter">subscription_name</replaceabl
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="sql-createsubscription-with-origin"> <varlistentry id="sql-createsubscription-params-with-origin">
<term><literal>origin</literal> (<type>string</type>)</term> <term><literal>origin</literal> (<type>string</type>)</term>
<listitem> <listitem>
<para> <para>
@ -452,8 +452,8 @@ CREATE SUBSCRIPTION <replaceable class="parameter">subscription_name</replaceabl
the case of different <literal>WHERE</literal> clauses, if one of the the case of different <literal>WHERE</literal> clauses, if one of the
publications has no <literal>WHERE</literal> clause (referring to that publications has no <literal>WHERE</literal> clause (referring to that
publish operation) or the publication is declared as publish operation) or the publication is declared as
<link linkend="sql-createpublication-for-all-tables"><literal>FOR ALL TABLES</literal></link> <link linkend="sql-createpublication-params-for-all-tables"><literal>FOR ALL TABLES</literal></link>
or <link linkend="sql-createpublication-for-tables-in-schema"><literal>FOR TABLES IN SCHEMA</literal></link>, or <link linkend="sql-createpublication-params-for-tables-in-schema"><literal>FOR TABLES IN SCHEMA</literal></link>,
rows are always published regardless of the definition of the other rows are always published regardless of the definition of the other
expressions. If the subscriber is a <productname>PostgreSQL</productname> expressions. If the subscriber is a <productname>PostgreSQL</productname>
version before 15, then any row filtering is ignored during the initial data version before 15, then any row filtering is ignored during the initial data
@ -461,7 +461,7 @@ CREATE SUBSCRIPTION <replaceable class="parameter">subscription_name</replaceabl
deleting any initially copied data that would be incompatible with deleting any initially copied data that would be incompatible with
subsequent filtering. Because initial data synchronization does not take subsequent filtering. Because initial data synchronization does not take
into account the publication into account the publication
<link linkend="sql-createpublication-with-publish"><literal>publish</literal></link> <link linkend="sql-createpublication-params-with-publish"><literal>publish</literal></link>
parameter when copying existing table data, some rows may be copied that parameter when copying existing table data, some rows may be copied that
would not be replicated using DML. See would not be replicated using DML. See
<xref linkend="logical-replication-subscription-examples"/> for examples. <xref linkend="logical-replication-subscription-examples"/> for examples.

2
doc/src/sgml/ref/pg_dump.sgml
View File

@ -1488,7 +1488,7 @@ CREATE DATABASE foo WITH TEMPLATE template0;
truncate the target tables before initiating a new full table copy. If users truncate the target tables before initiating a new full table copy. If users
intend to copy initial data during refresh they must create the slot with intend to copy initial data during refresh they must create the slot with
<literal>two_phase = false</literal>. After the initial sync, the <literal>two_phase = false</literal>. After the initial sync, the
<link linkend="sql-createsubscription-with-two-phase"><literal>two_phase</literal></link> <link linkend="sql-createsubscription-params-with-two-phase"><literal>two_phase</literal></link>
option will be automatically enabled by the subscriber if the subscription option will be automatically enabled by the subscriber if the subscription
had been originally created with <literal>two_phase = true</literal> option. had been originally created with <literal>two_phase = true</literal> option.
</para> </para>

4
doc/src/sgml/system-views.sgml
View File

@ -2151,8 +2151,8 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx
tables they contain. Unlike the underlying catalog tables they contain. Unlike the underlying catalog
<link linkend="catalog-pg-publication-rel"><structname>pg_publication_rel</structname></link>, <link linkend="catalog-pg-publication-rel"><structname>pg_publication_rel</structname></link>,
this view expands publications defined as this view expands publications defined as
<link linkend="sql-createpublication-for-all-tables"><literal>FOR ALL TABLES</literal></link> <link linkend="sql-createpublication-params-for-all-tables"><literal>FOR ALL TABLES</literal></link>
and <link linkend="sql-createpublication-for-tables-in-schema"><literal>FOR TABLES IN SCHEMA</literal></link>, and <link linkend="sql-createpublication-params-for-tables-in-schema"><literal>FOR TABLES IN SCHEMA</literal></link>,
so for such publications there will be a row for each eligible table. so for such publications there will be a row for each eligible table.
</para> </para>