1
0
mirror of https://github.com/postgres/postgres.git synced 2026-01-26 09:41:40 +03:00

doc: Improve description of publish_via_partition_root

Reword publish_via_partition_root's opening paragraph. Describe its
behavior more clearly, and directly state that its default is false.

Per complaint by Peter Smith; final text of the patch made in
collaboration with Chao Li.

Author: Chao Li <li.evan.chao@gmail.com>
Author: Peter Smith <peter.b.smith@fujitsu.com>
Reported-by: Peter Smith <peter.b.smith@fujitsu.com>
Reviewed-by: Amit Kapila <amit.kapila16@gmail.com>
Discussion: https://postgr.es/m/CAHut%2BPu7SpK%2BctOYoqYR3V4w5LKc9sCs6c_qotk9uTQJQ4zp6g%40mail.gmail.com
Backpatch-through: 14
This commit is contained in:
Jacob Champion
2026-01-09 09:59:15 -08:00
parent 7a1d422e39
commit e2aae8d68f

View File

@@ -255,13 +255,15 @@ CREATE PUBLICATION <replaceable class="parameter">name</replaceable>
<term><literal>publish_via_partition_root</literal> (<type>boolean</type>)</term>
<listitem>
<para>
This parameter determines whether changes in a partitioned table (or
on its partitions) contained in the publication will be published
using the identity and schema of the partitioned table rather than
that of the individual partitions that are actually changed; the
latter is the default. Enabling this allows the changes to be
replicated into a non-partitioned table or a partitioned table
consisting of a different set of partitions.
This parameter controls how changes to a partitioned table (or any of
its partitions) are published. When set to <literal>true</literal>,
changes are published using the identity and schema of the
root partitioned table. When set to <literal>false</literal> (the
default), changes are published using the identity and schema of the
individual partitions where the changes actually occurred. Enabling
this option allows the changes to be replicated into a
non-partitioned table or into a partitioned table whose partition
structure differs from that of the publisher.
</para>
<para>