Dual-Cluster Replication Parameters

enable_roach_standby_cluster

Parameter description: Sets the instances of the standby cluster to read-only in dual-cluster mode. Only the sysadmin user can access this parameter.

This is a POSTMASTER parameter. Set it based on instructions provided in Table 2.

Value range: Boolean

• on indicates that the read-only mode is enabled for the standby cluster.
• off indicates that the read-only mode is disabled for the standby cluster. In this case, the standby cluster can be read and written.

Default value: off

enable_slot_log

Parameter description: Specifies whether to enable primary/standby synchronization for replication slots. Currently, only archive slots and backup slots are involved.

Parameter type: Boolean.

Value range:

• on indicates that primary/standby synchronization is enabled for replication slots.
• off indicates that primary/standby synchronization is disabled for replication slots.

Default value: on

Setting method: This is a USERSET parameter. Set it based on instructions provided in Table 2.

Setting suggestion: Set this parameter to on only in cloud scenarios where logical replication is enabled. In other scenarios, set this parameter to off.

max_changes_in_memory

Parameter description: Specifies the maximum number of DML statements cached in memory for a single transaction during logical decoding.

This is a POSTMASTER parameter. Set it based on instructions provided in Table 2.

Value range: an integer ranging from 1 to 2147483647

Default value: 4096

max_cached_tuplebufs

Parameter description: Specifies the upper limit of the total tuple information cached in the memory during logical decoding. You are advised to set this parameter to a value greater than or equal to twice of max_changes_in_memory.

This is a POSTMASTER parameter. Set it based on instructions provided in Table 2.

Value range: an integer ranging from 1 to 2147483647

Default value: 8192

logical_decode_options_default

Parameter description: Specifies the global default value for unspecified decoding options when logical decoding starts.

This is a SIGHUP parameter. Set it based on instructions provided in Table 2.

Currently, the following logical decoding options are supported: parallel-decode-num, parallel-queue-size, max-txn-in-memory, max-reorderbuffer-in-memory, exclude-users, and skip-generated-columns. For details about the options, see "Logical Replication > Logical Decoding > Logical Decoding Options" in Feature Guide.

Value range: a string of key=value characters separated by commas (,), for example, 'parallel-decode-num=4,parallel-queue-size=128,exclude-users=userA,skip-generated-columns=on'. An empty string indicates that the default value of the program is used.

Default value: ""

• The SIGHUP parameter does not affect the started logic decoding process. The options specified by this parameter are used as the default settings for subsequent logic decoding startup, and the settings specified in the startup command are preferentially used.
• The exclude-users option is different from the logic decoding startup option. You are not allowed to specify multiple blacklisted users.

logical_sender_timeout

Parameter description: Specifies the maximum waiting time for the sender to wait for the receiver to receive logical logs.

This is a USERSET parameter. Set it based on instructions provided in Table 1.

Value range: an integer ranging from 0 to 2147483647. The unit is ms.

Default value: 30s

RepOriginId

Parameter description: This is a session-level GUC parameter. In bidirectional logical replication, set it to a non-zero value to avoid infinite data replication.

This is a USERSET parameter. Set it based on method 3 provided in Table 2.

Value range: an integer ranging from 0 to 2147483647

Default value: 0

auto_csn_barrier

Parameter description: Specifies whether the barrier logging function is enabled for the primary cluster for streaming DR.

This is a SIGHUP parameter. Set it based on instructions provided in Table 1.

Value range: Boolean

• on: enabled.
• off: disabled.

Default value: off

stream_cluster_run_mode

Parameter description: Specifies whether a CN or DN belongs to the primary or standby cluster in a dual-cluster streaming DR scenario. In a single-cluster scenario, the primary cluster is selected by default.

This is a POSTMASTER parameter. Set it based on instructions provided in Table 1.

Value range: enumerated values

• cluster_primary indicates that the node is in the primary cluster.
• cluster_standby indicates that the node is in the standby cluster.

Default value: cluster_primary

hadr_process_type

Parameter description: Specifies a process ID of a streaming replication-based remote DR solution or intra-city dual-center HA solution.

This is a SIGHUP parameter. Set it based on instructions provided in Table 2.

Value range: enumerated values.

• none indicates that there is no process.
• failover indicates that a DR cluster is promoted to primary.
• switchover_promote indicates that a DR cluster is promoted to primary during the cluster switchover.
• switchover_demote indicates that a primary cluster is demoted to a DR cluster during the cluster switchover.
• dorado_failover indicates that a Dorado DR cluster is promoted to primary.
• dorado_switchover_demote indicates that a primary cluster is demoted to a DR cluster during the Dorado cluster switchover.
• dorado_failover_abnormal indicates that a DR cluster is process to primary when a shared disk of the Dorado primary cluster is faulty.

Default value: none