postgres.git / summary / log / commit / refs
commit d2c6ff7c525bc6d67109021ad28faeb795fa2878
Author: Jacob Champion <jchampion@postgresql.org>
Date: Fri Jan 09 18:02:56 2026 +0000
First released in: 14.21, 15.16, 16.12, 17.8, 18.2
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
doc/src/sgml/ref/create_publication.sgml | 16 +++++++++-------
1 file changed, 9 insertions(+), 7 deletions(-)
diff --git a/doc/src/sgml/ref/create_publication.sgml b/doc/src/sgml/ref/create_publication.sgml
index 092a141dd87..e83da50e4fe 100644
--- a/doc/src/sgml/ref/create_publication.sgml
+++ b/doc/src/sgml/ref/create_publication.sgml
@@ -235,13 +235,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>
[parent: 39d55557661f]