From 4b6cd321abef530b6c1f296eb4bfcb05d280fb90 Mon Sep 17 00:00:00 2001 From: wangw Date: Wed, 28 Sep 2022 14:35:41 +0800 Subject: [PATCH v18 3/3] Add clarification for the behaviour of the publication parameter publish_via_partition_root Assume a subscription is subscribing to multiple publications, and these publications publish a partitioned table and its partitions respectively: [publisher-side] create table parent (a int primary key) partition by range (a); create table child partition of parent default; create publication pub1 for table parent; create publication pub2 for table child; [subscriber-side] create subscription sub connection 'xxxx' publication pub1, pub2; The manual does not clearly describe the behaviour when the user had specified the parameter 'publish_via_partition_root' on just one of the publications. This patch modifies documentation to clarify the following rules: - If the parameter publish_via_partition_root is specified only in pub1, changes will be published using the identity and schema of the table 'parent'. - If the parameter publish_via_partition_root is specified only in pub2, changes will be published using the identity and schema of the table 'child'. --- doc/src/sgml/ref/create_publication.sgml | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/doc/src/sgml/ref/create_publication.sgml b/doc/src/sgml/ref/create_publication.sgml index a2946feaa3..523c495a13 100644 --- a/doc/src/sgml/ref/create_publication.sgml +++ b/doc/src/sgml/ref/create_publication.sgml @@ -201,6 +201,16 @@ CREATE PUBLICATION name consisting of a different set of partitions. + + There can be a case where a subscription combines multiple + publications. If a root partitioned table is published by any + subscribed publications which set + publish_via_partition_root = true, changes on this + root partitioned table (or on its partitions) will be published using + the identity and schema of this root partitioned table rather than + that of the individual partitions. + + This parameter also affects how row filters and column lists are chosen for partitions; see below for details. -- 2.39.1.windows.1