postgres.git / summary / log / commit / refs

commit    862f83f3aa402f485877f50d5049decc14959283
Author:   Jacob Champion <jchampion@postgresql.org>
Date:     Fri Jan 09 18:02:49 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 6aedf158f7b..71971fc27d5 100644
--- a/doc/src/sgml/ref/create_publication.sgml
+++ b/doc/src/sgml/ref/create_publication.sgml
@@ -196,13 +196,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: 84b787ae66e6]