本文导读

展开导读

文档首页/ 云数据库 GaussDB/ 开发指南（分布式_V2.0-8.x）/ 配置运行参数/ GUC参数说明/ 集群事务

集群事务

更新时间：2025-05-29 GMT+08:00

查看PDF

介绍集群事务隔离、事务只读、最大prepared事务数、集群维护模式目的参数设置及取值范围等内容。

transaction_isolation

参数说明：设置当前事务的隔离级别。对于开启的新事务，隔离级别固定为default_transaction_isolation的值。

参数类型：字符串

参数单位：无

取值范围：只支持以下字符串，对大小写和空格敏感。

'serializable'：GaussDB目前功能上不支持此隔离级别，设置该隔离级别时，与'repeatable read'效果相同。
'read committed'：仅读取已提交事务的数据，无法读取未提交的数据。
'read uncommitted'：与'read committed'表现相同。
'repeatable read'：仅读取事务开始之前提交的数据，无法读取未提交的数据以及在事务执行期间由其他并发事务提交的修改。
'default'：设置为default_transaction_isolation所设的隔离级别。

默认值：'default'。default_transaction_isolation参数使用默认值'read committed'的情况下，通过show transaction_isolation;命令查询的结果为'read committed'。

设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。

设置建议：推荐使用默认值。

设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

transaction_read_only

参数说明：设置当前事务是否为只读事务。

参数类型：布尔型

参数单位：无

取值范围：

on：表示设置当前事务为只读事务。
off：表示设置当前事务为读写事务。

默认值：off

设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。

设置建议：推荐使用默认值。

设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

xc_maintenance_mode

参数说明：设置系统进入维护模式。

参数类型：布尔型

参数单位：无

取值范围：

on：表示进入维护模式。
off：表示不进入维护模式。

须知：

谨慎打开这个功能，避免引起集群数据不一致。

默认值：off

设置方式：该参数属于SUSET类型参数，仅支持表2中的方式三进行设置。

设置建议：该参数一般供维护人员排查问题使用，不建议用户开启。

设置不当的风险与影响：修改该参数取值可能导致集群出现意料之外的结果，请保持默认值。

allow_concurrent_tuple_update

参数说明：设置是否允许并发更新。

参数类型：布尔型

参数单位：无

取值范围：

on：表示允许并发更新。
off：表示不允许并发更新。

默认值：on

设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。

设置建议：推荐使用默认值。

设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

gtm_host

参数说明：主GTM进程所在的IP地址。仅sysadmin用户可见。该地址支持IPv4与IPv6格式。

参数类型：字符串

参数单位：无

取值范围：字符串

默认值：主GTM的IP地址。

设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。

设置建议：推荐使用默认值。

设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

gtm_port

参数说明：主GTM进程的侦听端口。仅sysadmin用户可见。

说明：

该参数由安装时的配置文件指定，请勿轻易修改，否则修改后会影响数据库正常通信。

参数类型：整型

参数单位：无

取值范围：1 ~ 65535

默认值：安装时指定。

设置方式：该参数属于POSTMASTER类型参数。

设置建议：不建议进行修改。

设置不当的风险与影响：修改端口号会影响数据库正常通信。

gtm_host1

参数说明：备GTM进程所在的IP地址。仅sysadmin用户可见。该地址支持IPv4与IPv6格式。

参数类型：字符串

参数单位：无

取值范围：字符串

默认值：备GTM的IP地址。

设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。

设置建议：推荐使用默认值。

设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

gtm_port1

参数说明：备GTM进程的侦听端口。仅sysadmin用户可见。

说明：

该参数由安装时的配置文件指定，请勿轻易修改，否则修改后会影响数据库正常通信。

参数类型：整型

参数单位：无

取值范围：1 ~ 65535

默认值：如有备1，安装指定。否则为6665。

设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。

设置建议：不建议进行修改。

设置不当的风险与影响：修改端口号会影响数据库正常通信。

gtm_backup_barrier

参数说明：指定是否为GTM启动点创建还原点。

参数类型：布尔型

参数单位：无

取值范围：

on：表示创建还原点。
off：表示不创建还原点。

默认值：off

设置方式：该参数属于SUSET类型参数，请参考表1中对应设置方法进行设置。

设置建议：推荐使用默认值。

设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

gtm_conn_check_interval

参数说明：设置检查CN本地线程与主GTM连接是否正常的间隔时间。

参数类型：整型

参数单位：s（秒）

取值范围：0 ~ 2147483

默认值：10

设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。

设置建议：推荐使用默认值。

设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

enable_show_any_tuples

参数说明：该参数只有在只读事务中可用，用于分析。当这个参数被置为on时，表中元组的所有版本都会可见。

参数类型：布尔型

参数单位：无

取值范围：

on：表示表中元组的所有版本都会可见。
off：表示表中元组的所有版本都不可见。

默认值：off

设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。

设置建议：推荐使用默认值。

设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

说明：

在toast场景下，如果reindex前后均有DML操作（主要是insert+update或insert+delete），在reindex操作后，开启只读事务并打开该GUC参数，release版本下单独查询toast表或toast索引表历史数据正常，但是通过主表查询toast列历史数据会报错“missing chunk number xxx”。

gtm_connect_timeout

参数说明：控制GTM连接超时时间，如果GTM的连接时间超过此参数设置的值，则超时返回。

参数类型：整型

参数单位：s（秒）

取值范围：1 ~ 2147483647

默认值：2

设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。

设置建议：推荐使用默认值。

设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

gtm_connect_retries

参数说明：控制GTM连接重试的次数。

参数类型：整型

参数单位：无

取值范围：1 ~ 2147483647

默认值：30

设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。

设置建议：推荐使用默认值。

设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

gtm_rw_timeout

参数说明：控制GTM反馈超时时间，如果GTM的反馈时间超过此参数设置的值，也就是等待时间超过了此参数值，则超时返回。

参数类型：整型

参数单位：s（秒）

取值范围：1 ~ 2147483647

默认值：60（1min）

设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。

设置建议：推荐使用默认值。

设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

enable_redistribute

参数说明：节点不匹配时是否重新分配。

参数类型：布尔型

参数单位：无

取值范围：

on：表示节点不匹配时重新分配。
off：表示节点不匹配时不重新分配。

默认值：off

设置方式：该参数属于SUSET类型参数，请参考表1中对应设置方法进行设置。

设置建议：推荐使用默认值。

设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

replication_type

参数说明：标记当前部署模式是一主多备模式或单主机模式。

参数类型：整型

参数单位：无

取值范围：0 ~ 3

0：是预留参数。
1：表示使用一主多备模式，全场景覆盖，推荐使用。
2：表示使用单主机模式，此模式无法扩展备机。
3：是预留参数。

默认值：1

设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。该参数是CM部署时使用的参数，用户不能对该参数进行设置。

设置建议：推荐使用默认值。

设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

pgxc_node_name

参数说明：指定节点名称。

在备机请求主机进行日志复制时，如果application_name参数没有被设置，那么pgxc_node_name参数会被用来作为备机在主机上的流复制槽名字。该流复制槽的命名方式为“该参数值_备机ip_备机port”。其中，备机ip和备机port取自replconninfo参数中指定的备机ip和端口号。该流复制槽最大长度为61个字符，如果拼接后的字符串超过该长度，则会使用截断后的pgxc_node_name进行拼接，以保证流复制槽名字长度小于等于61个字符。

参数类型：字符串

参数单位：无

取值范围：字符串

默认值：当前节点名称。

设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。

设置建议：不建议进行修改。

设置不当的风险与影响：修改后会导致连接集群失败。

enable_gtm_free

参数说明：大并发场景下同一时刻存在活跃事务较多，GTM下发的快照变大且快照请求变多的情况下，瓶颈卡在GTM与CN通讯的网络上。为消除该瓶颈，引入GTM-FREE模式。取消CN和GTM的交互，取消CN下发GTM获取的事务信息给DN。CN只向各个DN发送query，各个DN由本地产生快照及xid等信息，开启该参数支持分布式事务读最终一致性，即分布式事务只有写外部一致性，不具有读外部一致性。

须知：

业务使用GTM-Free模式时，建议将application_type设置成perfect_sharding_type，以便及时发现可能导致数据不一致的SQL语句。否则，系统不会拦截可能导致数据不一致的语句，造成数据不一致。

参数类型：布尔型

参数单位：无

取值范围：

on：表示开启GTM-FREE模式，集群状态为读最终一致性。
off：表示非GTM-FREE模式。

默认值：off

设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。

设置建议：推荐使用默认值。

设置不当的风险与影响：GTM-FREE模式有可能出现数据不一致问题。

enable_twophase_commit

参数说明：当前云数据库解决SDS替换问题，采用的模式为GTM Free，为防止业务滥用导致不可靠问题，提供guc参数开关enable_twophase_commit允许或禁用分布式两阶段写事务。

参数类型：布尔型

参数单位：无

取值范围：

on：表示GTM-FREE模式下，允许分布式两阶段写事务。
off：表示GTM-FREE模式下，禁用分布式两阶段写事务。

默认值：on

设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。

设置建议：推荐使用默认值。

设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

application_type

参数说明：此参数仅在enable_gtm_free为on时有效。此参数用来说明用户的业务类型。

参数类型：枚举类型

参数单位：无

取值范围：

not_perfect_sharding_type：表示跨节点的业务。设置此值时，允许执行跨节点的语句。
perfect_sharding_type：表示单节点的业务。设置此值时，如果SQL语句需要多个节点参与，会直接报错，对应的SQL语句会同时打印到系统日志中。设置为此值时，使用/*+ multinode */ hint可以显式允许SQL语句在多个节点执行。multinode hint可以加到select、insert、update、delete、merge关键字之后。

设置方式：该参数属于USERSET类型参数，此参数不支持使用gs_guc设置，只支持以下两种方式设置：

使用gsql等客户端在session级别设置。
使用jdbc连接数据库时，在连接字符串中指定ApplicationType参数。

设置建议：推荐使用默认值。

设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

gtm_host2

参数说明：如有2号GTM，参数值为2号GTM进程所在的IP地址。仅sysadmin用户可见。该地址支持IPv4与IPv6格式。

参数类型：字符串

参数单位：无

取值范围：字符串

默认值：如有2号GTM，为GTM的IP地址，否则为“”。

设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。

设置建议：推荐使用默认值。

设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

gtm_host3

参数说明：如有3号GTM，参数值为3号GTM进程所在的IP地址。仅sysadmin用户可见。该地址支持IPv4与IPv6格式。

参数类型：字符串

参数单位：无

取值范围：字符串

默认值：如有3号GTM，为GTM的IP地址，否则为“”。

设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。

设置建议：推荐使用默认值。

设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

gtm_host4

参数说明：如有4号GTM，参数值为4号GTM进程所在的P地址。仅sysadmin用户可见。该地址支持IPv4与IPv6格式。

参数类型：字符串

参数单位：无

取值范围：字符串

默认值：如有4号GTM，为GTM的IP地址，否则为“”。

设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。

设置建议：推荐使用默认值。

设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

gtm_host5

参数说明：如有5号GTM，参数值为5号GTM进程所在的IP地址。仅sysadmin用户可见。该地址支持IPv4与IPv6格式。

参数类型：字符串

参数单位：无

取值范围：字符串

默认值：如有5号GTM，为GTM的IP地址，否则为“”。

设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。

设置建议：推荐使用默认值。

设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

gtm_host6

参数说明：如有6号GTM，参数值为6号GTM进程所在的P地址。仅sysadmin用户可见。该地址支持IPv4与IPv6格式。

参数类型：字符串

参数单位：无

取值范围：字符串

默认值：如有6号GTM，为GTM的IP地址，否则为“”。

设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。

设置建议：推荐使用默认值。

设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

gtm_host7

参数说明：如有7号GTM，参数值为7号GTM进程所在的IP地址。仅sysadmin用户可见。该地址支持IPv4与IPv6格式。

参数类型：字符串

参数单位：无

取值范围：字符串

默认值：如有7号GTM，为GTM的IP地址，否则为“”。

设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。

设置建议：推荐使用默认值。

设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

gtm_port2

参数说明：如有2号GTM，参数值为2号GTM进程的侦听端口。仅sysadmin用户可见。

参数类型：整型

参数单位：无

取值范围：1 ~ 65535

默认值：如有2号GTM，安装时指定。否则为6666。

设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。

设置建议：不建议进行修改。

设置不当的风险与影响：修改端口号会影响数据库正常通信。

gtm_port3

参数说明：如有3号GTM，参数值为3号GTM进程的侦听端口。仅sysadmin用户可见。

参数类型：整型

参数单位：无

取值范围：1 ~ 65535

默认值：如有3号GTM，安装时指定。否则为6666。

设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。

设置建议：不建议进行修改。

设置不当的风险与影响：修改端口号会影响数据库正常通信。

gtm_port4

参数说明：如有4号GTM，参数值为4号GTM进程的侦听端口。仅sysadmin用户可见。

参数类型：整型

参数单位：无

取值范围：1 ~ 65535

默认值：如有4号GTM，安装时指定。否则为6666。

设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。

设置建议：不建议进行修改。

设置不当的风险与影响：修改端口号会影响数据库正常通信。

gtm_port5

参数说明：如有5号GTM，参数值为5号GTM进程的侦听端口。仅sysadmin用户可见。

参数类型：整型

参数单位：无

取值范围：1 ~ 65535

默认值：如有5号GTM，安装时指定。否则为6666。

设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。

设置建议：不建议进行修改。

设置不当的风险与影响：修改端口号会影响数据库正常通信。

gtm_port6

参数说明：如有6号GTM，参数值为6号GTM进程的侦听端口。仅sysadmin用户可见。

参数类型：整型

参数单位：无

取值范围：1 ~ 65535

默认值：如有6号GTM，安装时指定。否则为6666。

设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。

设置建议：不建议进行修改。

设置不当的风险与影响：修改端口号会影响数据库正常通信。

gtm_port7

参数说明：如有7号GTM，参数值为7号GTM进程的侦听端口。仅sysadmin用户可见。

参数类型：整型

参数单位：无

取值范围：1 ~ 65535

默认值：如有7号GTM，安装时指定。否则为6666。

设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。

设置建议：不建议进行修改。

设置不当的风险与影响：修改端口号会影响数据库正常通信。

enable_defer_calculate_snapshot

参数说明：延迟计算快照的xmin和oldestxmin，执行1000个事务或者间隔1s才触发计算。

参数类型：布尔型

参数单位：无

取值范围：

on：表示延迟计算快照xmin和oldestxmin。
off：表示实时计算快照xmin和oldestxmin。

默认值：on

设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。

设置建议：推荐使用默认值。

设置不当的风险与影响：设置为on时可以在高负载场景下减少计算快照的开销，但是会导致oldestxmin推进较慢，影响垃圾元组回收。设置为off时xmin和oldestxmin可以实时推进，但是会增加计算快照时的开销。

seqscan_csn_cache_num

参数说明：此参数控制csn cache的大小，此cache只有在seqscan通过MVCC快照扫描heap表页面判断可见性会使用到。

参数类型：整型

参数单位：无

取值范围：0 ~ 1000。参数值为0时，表示不使用csn缓存机制。

默认值：100

设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。

设置建议：推荐使用默认值。

设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

reject_gtm_address

参数说明：设置拒绝连接的GTM IP地址。

参数类型：字符串

参数单位：无

取值范围：以逗号分隔，分隔后的每个子串格式为IP[:port]。

说明：

上述的[:port]表示可选。

默认值：""

设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。

设置建议：仅由CM组件在特定流程中自动设置，不建议手动进行修改。

设置不当的风险与影响：不当设置可能导致集群与GTM之间无法进行通信，进而影响集群事务。

父主题： GUC参数说明

上一篇：连接池参数

下一篇：双集群复制参数

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

集群事务

transaction_isolation

transaction_read_only

xc_maintenance_mode

allow_concurrent_tuple_update

gtm_host

gtm_port

gtm_host1

gtm_port1

gtm_backup_barrier

gtm_conn_check_interval

enable_show_any_tuples

gtm_connect_timeout

gtm_connect_retries

gtm_rw_timeout

enable_redistribute

replication_type

pgxc_node_name

enable_gtm_free

enable_twophase_commit

application_type

gtm_host2

gtm_host3

gtm_host4

gtm_host5

gtm_host6

gtm_host7

gtm_port2

gtm_port3

gtm_port4

gtm_port5

gtm_port6

gtm_port7

enable_defer_calculate_snapshot

seqscan_csn_cache_num

reject_gtm_address

意见反馈

文档内容是否对您有帮助？

文档反馈