From bd05985c8fc35d33bb264c090ddece44f6928749 Mon Sep 17 00:00:00 2001 From: Peter Smith Date: Fri, 13 Oct 2023 14:23:19 +1100 Subject: [PATCH v5] Change ids for CREATE SUBSCRIPTION parameters --- doc/src/sgml/config.sgml | 2 +- doc/src/sgml/logical-replication.sgml | 12 +++++------ doc/src/sgml/ref/alter_subscription.sgml | 26 +++++++++++------------ doc/src/sgml/ref/create_subscription.sgml | 34 +++++++++++++++---------------- doc/src/sgml/ref/pg_dump.sgml | 2 +- 5 files changed, 38 insertions(+), 38 deletions(-) diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml index 3839c72..d244390 100644 --- a/doc/src/sgml/config.sgml +++ b/doc/src/sgml/config.sgml @@ -11686,7 +11686,7 @@ LOG: CleanUpLock: deleting: lock(0xb7acd844) id(24688,24696,0,0,0,1) On the publisher side, debug_logical_replication_streaming allows streaming or serializing changes immediately in logical decoding. When set to immediate, stream each change if the - streaming + streaming option of CREATE SUBSCRIPTION is enabled, otherwise, serialize each change. When set to diff --git a/doc/src/sgml/logical-replication.sgml b/doc/src/sgml/logical-replication.sgml index 9f0f059..1bb85e4 100644 --- a/doc/src/sgml/logical-replication.sgml +++ b/doc/src/sgml/logical-replication.sgml @@ -253,7 +253,7 @@ will be filled with the default value as specified in the definition of the target table. However, logical replication in binary format is more restrictive. See the - binary + binary option of CREATE SUBSCRIPTION for details. @@ -593,7 +593,7 @@ ALTER SUBSCRIPTION Example 2: Where the subscription says connect = false, but also specifies the - slot_name + slot_name option. @@ -712,7 +712,7 @@ ALTER SUBSCRIPTION then the row is not replicated. The WHERE clause expression is evaluated with the same role used for the replication connection (i.e. the role specified in the - CONNECTION + CONNECTION clause of the ). Row filters have no effect for TRUNCATE command. @@ -1518,7 +1518,7 @@ CONTEXT: processing remote data for replication origin "pg_16395" during "INSER either by ALTER SUBSCRIPTION ... DISABLE or, the subscription can be used with the - disable_on_error + disable_on_error option. Then, you can use pg_replication_origin_advance() function with the node_name (i.e., pg_16395) and the next LSN of the finish LSN (i.e., 0/14C0379). The current position of @@ -1531,7 +1531,7 @@ CONTEXT: processing remote data for replication origin "pg_16395" during "INSER When the - streaming + streaming mode is parallel, the finish LSN of failed transactions may not be logged. In that case, it may be necessary to change the streaming mode to on or off and cause the same @@ -1743,7 +1743,7 @@ CONTEXT: processing remote data for replication origin "pg_16395" during "INSER zero rows in this view. If the initial data synchronization of any table is in progress, there will be additional workers for the tables being synchronized. Moreover, if the - streaming + streaming transaction is applied in parallel, there may be additional parallel apply workers. diff --git a/doc/src/sgml/ref/alter_subscription.sgml b/doc/src/sgml/ref/alter_subscription.sgml index ba70855..6d36ff0 100644 --- a/doc/src/sgml/ref/alter_subscription.sgml +++ b/doc/src/sgml/ref/alter_subscription.sgml @@ -72,9 +72,9 @@ ALTER SUBSCRIPTION name RENAME TO < executed inside a transaction block. These commands also cannot be executed when the subscription has - two_phase + two_phase commit enabled, unless - copy_data + copy_data is false. See column subtwophasestate of pg_subscription to know the actual two-phase state. @@ -178,12 +178,12 @@ ALTER SUBSCRIPTION name RENAME TO < See for details of how copy_data = true can interact with the - origin + origin parameter. See the - binary + binary parameter of CREATE SUBSCRIPTION for details about copying pre-existing data in binary format. @@ -220,14 +220,14 @@ ALTER SUBSCRIPTION name RENAME TO < This clause alters parameters originally set by . See there for more information. The parameters that can be altered are - slot_name, - synchronous_commit, - binary, - streaming, - disable_on_error, - password_required, - run_as_owner, and - origin. + slot_name, + synchronous_commit, + binary, + streaming, + disable_on_error, + password_required, + run_as_owner, and + origin. Only a superuser can set password_required = false. @@ -243,7 +243,7 @@ ALTER SUBSCRIPTION name RENAME TO < the logical replication worker skips all data modification changes within the transaction. This option has no effect on the transactions that are already prepared by enabling - two_phase + two_phase on the subscriber. After the logical replication worker successfully skips the transaction or finishes a transaction, the LSN (stored in diff --git a/doc/src/sgml/ref/create_subscription.sgml b/doc/src/sgml/ref/create_subscription.sgml index db11ebc..f1c20b3 100644 --- a/doc/src/sgml/ref/create_subscription.sgml +++ b/doc/src/sgml/ref/create_subscription.sgml @@ -68,7 +68,7 @@ CREATE SUBSCRIPTION subscription_nameParameters - + subscription_name @@ -77,7 +77,7 @@ CREATE SUBSCRIPTION subscription_name - + CONNECTION 'conninfo' @@ -88,7 +88,7 @@ CREATE SUBSCRIPTION subscription_name - + PUBLICATION publication_name [, ...] @@ -97,7 +97,7 @@ CREATE SUBSCRIPTION subscription_name - + WITH ( subscription_parameter [= value] [, ... ] ) @@ -109,7 +109,7 @@ CREATE SUBSCRIPTION subscription_name - + connect (boolean) @@ -136,7 +136,7 @@ CREATE SUBSCRIPTION subscription_name - + create_slot (boolean) @@ -152,7 +152,7 @@ CREATE SUBSCRIPTION subscription_name - + enabled (boolean) @@ -163,7 +163,7 @@ CREATE SUBSCRIPTION subscription_name - + slot_name (string) @@ -192,7 +192,7 @@ CREATE SUBSCRIPTION subscription_name - + binary (boolean) @@ -229,7 +229,7 @@ CREATE SUBSCRIPTION subscription_name - + copy_data (boolean) @@ -250,7 +250,7 @@ CREATE SUBSCRIPTION subscription_name - + streaming (enum) @@ -278,7 +278,7 @@ CREATE SUBSCRIPTION subscription_name - + synchronous_commit (enum) @@ -310,7 +310,7 @@ CREATE SUBSCRIPTION subscription_name - + two_phase (boolean) @@ -341,7 +341,7 @@ CREATE SUBSCRIPTION subscription_name - + disable_on_error (boolean) @@ -353,7 +353,7 @@ CREATE SUBSCRIPTION subscription_name - + password_required (boolean) @@ -366,7 +366,7 @@ CREATE SUBSCRIPTION subscription_name - + run_as_owner (boolean) @@ -380,7 +380,7 @@ CREATE SUBSCRIPTION subscription_name - + origin (string) diff --git a/doc/src/sgml/ref/pg_dump.sgml b/doc/src/sgml/ref/pg_dump.sgml index 1417d70..8695571 100644 --- a/doc/src/sgml/ref/pg_dump.sgml +++ b/doc/src/sgml/ref/pg_dump.sgml @@ -1488,7 +1488,7 @@ CREATE DATABASE foo WITH TEMPLATE template0; truncate the target tables before initiating a new full table copy. If users intend to copy initial data during refresh they must create the slot with two_phase = false. After the initial sync, the - two_phase + two_phase option will be automatically enabled by the subscriber if the subscription had been originally created with two_phase = true option. -- 1.8.3.1