From bba5fca096d9e4a164311a4a7f731062c95a54b1 Mon Sep 17 00:00:00 2001 From: Peter Smith Date: Fri, 13 Oct 2023 14:06:10 +1100 Subject: [PATCH v5] Change ids for CREATE PUBLICATION parameters --- doc/src/sgml/logical-replication.sgml | 22 +++++++++++----------- doc/src/sgml/ref/alter_publication.sgml | 6 +++--- doc/src/sgml/ref/create_publication.sgml | 14 +++++++------- doc/src/sgml/ref/create_subscription.sgml | 6 +++--- doc/src/sgml/system-views.sgml | 4 ++-- 5 files changed, 26 insertions(+), 26 deletions(-) diff --git a/doc/src/sgml/logical-replication.sgml b/doc/src/sgml/logical-replication.sgml index 8c3837e..9f0f059 100644 --- a/doc/src/sgml/logical-replication.sgml +++ b/doc/src/sgml/logical-replication.sgml @@ -371,7 +371,7 @@ INSERT 0 3 Create publications for the tables. The publications pub2 and pub3a disallow some - publish + publish operations. The publication pub3b has a row filter (see ). @@ -805,7 +805,7 @@ ALTER SUBSCRIPTION If the publication contains a partitioned table, the publication parameter - publish_via_partition_root + publish_via_partition_root determines which row filter is used. If publish_via_partition_root is true, the root partitioned table's row filter is used. Otherwise, if publish_via_partition_root @@ -834,7 +834,7 @@ ALTER SUBSCRIPTION Because initial data synchronization does not take into account the - publish + publish parameter when copying existing table data, some rows may be copied that would not be replicated using DML. Refer to , and see @@ -858,7 +858,7 @@ ALTER SUBSCRIPTION If the subscription has several publications in which the same table has been published with different row filters (for the same - publish + publish operation), those expressions get ORed together, so that rows satisfying any of the expressions will be replicated. This means all the other row filters for the same table become redundant if: @@ -871,14 +871,14 @@ ALTER SUBSCRIPTION One of the publications was created using - FOR ALL TABLES. + FOR ALL TABLES. This clause does not allow row filters. One of the publications was created using - FOR TABLES IN SCHEMA + FOR TABLES IN SCHEMA and the table belongs to the referred schema. This clause does not allow row filters. @@ -1145,7 +1145,7 @@ test_sub=# SELECT * FROM t1; The following examples show how the publication parameter - publish_via_partition_root + publish_via_partition_root determines whether the row filter of the parent or child table will be used in the case of partitioned tables. @@ -1300,13 +1300,13 @@ test_sub=# SELECT * FROM child ORDER BY a; Specifying a column list when the publication also publishes - FOR TABLES IN SCHEMA + FOR TABLES IN SCHEMA is not supported. For partitioned tables, the publication parameter - publish_via_partition_root + publish_via_partition_root determines which column list is used. If publish_via_partition_root is true, the root partitioned table's column list is used. Otherwise, if publish_via_partition_root is @@ -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 that of the individual leaf partitions in which the changes actually originate (see - publish_via_partition_root + publish_via_partition_root parameter of CREATE PUBLICATION). @@ -1709,7 +1709,7 @@ CONTEXT: processing remote data for replication origin "pg_16395" during "INSER The publication - publish + publish parameter only affects what DML operations will be replicated. The initial data synchronization does not take this parameter into account when copying the existing table data. diff --git a/doc/src/sgml/ref/alter_publication.sgml b/doc/src/sgml/ref/alter_publication.sgml index 74fda82..44ae7e0 100644 --- a/doc/src/sgml/ref/alter_publication.sgml +++ b/doc/src/sgml/ref/alter_publication.sgml @@ -56,7 +56,7 @@ ALTER PUBLICATION name RENAME TO DROP TABLES IN SCHEMA will not drop any schema tables that were specified using - FOR TABLE/ + FOR TABLE/ ADD TABLE, and the combination of DROP with a WHERE clause is not allowed. @@ -82,8 +82,8 @@ ALTER PUBLICATION name RENAME TO CREATE privilege on the database. Also, the new owner of a - FOR ALL TABLES - or FOR TABLES IN SCHEMA + FOR ALL TABLES + or FOR TABLES IN SCHEMA publication must be a superuser. However, a superuser can change the ownership of a publication regardless of these restrictions. diff --git a/doc/src/sgml/ref/create_publication.sgml b/doc/src/sgml/ref/create_publication.sgml index 606aa64..fd9c5de 100644 --- a/doc/src/sgml/ref/create_publication.sgml +++ b/doc/src/sgml/ref/create_publication.sgml @@ -54,7 +54,7 @@ CREATE PUBLICATION name Parameters - + name @@ -63,7 +63,7 @@ CREATE PUBLICATION name - + FOR TABLE @@ -117,7 +117,7 @@ CREATE PUBLICATION name - + FOR ALL TABLES @@ -127,7 +127,7 @@ CREATE PUBLICATION name - + FOR TABLES IN SCHEMA @@ -158,7 +158,7 @@ CREATE PUBLICATION name - + WITH ( publication_parameter [= value] [, ... ] ) @@ -166,7 +166,7 @@ CREATE PUBLICATION name following parameters are supported: - + publish (string) @@ -188,7 +188,7 @@ CREATE PUBLICATION name - + publish_via_partition_root (boolean) diff --git a/doc/src/sgml/ref/create_subscription.sgml b/doc/src/sgml/ref/create_subscription.sgml index c1bafbf..db11ebc 100644 --- a/doc/src/sgml/ref/create_subscription.sgml +++ b/doc/src/sgml/ref/create_subscription.sgml @@ -452,8 +452,8 @@ CREATE SUBSCRIPTION subscription_nameWHERE clauses, if one of the publications has no WHERE clause (referring to that publish operation) or the publication is declared as - FOR ALL TABLES - or FOR TABLES IN SCHEMA, + FOR ALL TABLES + or FOR TABLES IN SCHEMA, rows are always published regardless of the definition of the other expressions. If the subscriber is a PostgreSQL version before 15, then any row filtering is ignored during the initial data @@ -461,7 +461,7 @@ CREATE SUBSCRIPTION subscription_namepublish + publish parameter when copying existing table data, some rows may be copied that would not be replicated using DML. See for examples. diff --git a/doc/src/sgml/system-views.sgml b/doc/src/sgml/system-views.sgml index 2b35c2f..fc7329e 100644 --- a/doc/src/sgml/system-views.sgml +++ b/doc/src/sgml/system-views.sgml @@ -2151,8 +2151,8 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx tables they contain. Unlike the underlying catalog pg_publication_rel, this view expands publications defined as - FOR ALL TABLES - and FOR TABLES IN SCHEMA, + FOR ALL TABLES + and FOR TABLES IN SCHEMA, so for such publications there will be a row for each eligible table. -- 1.8.3.1