华为云用户手册

enable_control_group 参数说明：是否开启Cgroups功能。此参数需在CN和DN同时应用。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：布尔型 on表示打开Cgroups管理。 off表示关闭Cgroups管理。 默认值：on 当使用表1中的方式二来修改参数值时，新参数值只能对更改操作执行后启动的线程生效。此外，对于后台线程以及线程复用执行的新作业，该值的改动不会生效。如果希望这类线程即时识别参数变化，可以使用kill session或重启节点的方式来实现。

enable_vacuum_control 参数说明：是否控制数据库常驻线程autoVacuumWorker到Vacuum控制组。此参数需在CN和DN同时应用。 该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 取值范围：布尔型 on表示控制数据库常驻线程autoVacuumWorker到Vacuum控制组。 off表示不控制数据库常驻线程autoVacuumWorker到Vacuum控制组。 默认值：on

cgroup_name 参数说明：设置当前使用的Cgroups的名称或者调整当前group下排队的优先级。 即如果先设置cgroup_name，再设置session_respool，那么session_respool关联的控制组起作用，如果再切换cgroup_name，那么新切换的cgroup_name起作用。 切换cgroup_name的过程中如果指定到Workload控制组级别，数据库不对级别进行验证。级别的范围只要在1-10范围内都可以。 该参数属于USERSET类型参数，请参考表1中方式三的方法进行设置。 建议尽量不要混合使用cgroup_name和session_respool。 取值范围：字符串 默认值：DefaultClass:Medium DefaultClass:Medium表示DefaultClass下Timeshare控制组中的Medium控制组。

restart_after_crash 参数说明：设置为on，后端进程崩溃时，GaussDB将自动重新初始化此后端进程。 该参数属于SIGHUP类型参数，请参考表2中对应设置方法进行设置。 取值范围：布尔型 on表示能够最大限度地提高数据库的可用性。 在某些情况（比如当采用管理工具（例如xCAT）管理GaussDB时），能够最大限度地提高数据库的可用性。 off表示能够使得管理工具在后端进程崩溃时获取控制权并采取适当的措施进行处理。 默认值：on

omit_encoding_error 参数说明：设置为on，数据库的客户端字符集编码为UTF-8时，出现的字符编码转换错误将打印在日志中，有转换错误的被转换字符会被忽略，以"?"代替。 该参数属于USERSET类型参数，请参考表2中对应设置方法进行设置。 取值范围：布尔型 on表示有转换错误的字符将被忽略，以"?"代替，打印错误信息到日志中。 off表示有转换错误的字符不能被转换，打印错误信息到终端。 默认值：off 若该参数通过执行gs_guc reload修改时，如果当前节点上的某个session的连接不是来自于客户端，而是来自于该节点所属集群上的其他节点，那么执行gs_guc reload后该参数在该session上不会立即生效，需与连接节点断开连接后重新连接才会生效。

retry_ecode_list 当前特性是实验室特性，使用时请联系华为工程师提供技术支持。 参数说明：指定SQL语句出错自动重试功能支持的错误类型列表。 该参数属于USERSET类型参数，请参考表2中对应设置方法进行设置。 取值范围：字符串 默认值：YY001 YY002 YY003 YY004 YY005 YY006 YY007 YY008 YY009 YY010 YY011 YY012 YY013 YY014 YY015 53200 08006 08000 57P01 XX003 XX009 YY016

data_sync_retry 参数说明：控制当fsync到磁盘失败后是否继续运行数据库。由于在某些操作系统的场景下，fsync失败后重试阶段即使再次fsync失败也不会报错，从而导致数据丢失。 该参数属于POSTMASTER类型参数，请参考表2中对应设置方法进行设置。 取值范围：布尔型 on表示当fsync同步到磁盘失败后采取重试机制，数据库继续运行。 off表示当fsync同步到磁盘失败后直接报panic，停止数据库。 默认值：off

remote_read_mode 参数说明：远程读功能开关。读取主机上的页面失败时可以从备机上读取对应的页面。 该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 取值范围：枚举类型 off表示关闭远程读功能。 non_authentication表示开启远程读功能，但不进行证书认证。 authentication表示开启远程读功能，但要进行证书认证。 默认值：authentication

default_with_oids 参数说明：在没有声明WITH OIDS和WITHOUT OIDS的情况下，这个选项控制在新创建的表中CREATE TABLE和CREATE TABLE AS是否包含一个OID字段。它还决定SELECT INTO创建的表里面是否包含OID 。 不推荐在用户表中使用OID，故默认设置为off。需要带有OID字段的表应该在创建时声明WITH OIDS 。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 取值范围：布尔型 on表示在新创建的表中CREATE TABLE和CREATE TABLE AS可以包含一个OID字段。 off表示在新创建的表中CREATE TABLE和CREATE TABLE AS不可以包含一个OID字段。 默认值：off

escape_string_warning 参数说明：警告在普通字符串中直接使用反斜杠转义。 如果需要使用反斜杠作为转义，可以调整为使用转义字符串语法(E'...')来做转义，因为在每个SQL标准中，普通字符串的默认行为现在将反斜杠作为一个普通字符。 这个变量可以帮助定位需要改变的代码。 使用E转义会导致部分场景下日志记录不全。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 取值范围：布尔型 默认值：on

quote_all_identifiers 参数说明：当数据库生成SQL时，此选项强制引用所有的标识符（包括非关键字）。这将影响到EXPLAIN的输出及函数的结果，例如pg_get_viewdef。详细说明请参见gs_dump的--quote-all-identifiers选项。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 取值范围：布尔型 on表示打开强制引用。 off表示关闭强制引用。 默认值：off

standard_conforming_strings 参数说明：控制普通字符串文本（'...'）中是否按照SQL标准把反斜扛当普通文本。 应用程序通过检查这个参数可以判断字符串文本的处理方式。 建议明确使用转义字符串语法（E'...'）来转义字符。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 取值范围：布尔型 on表示打开控制功能。 off表示关闭控制功能。 默认值：on

enable_beta_features 参数说明：控制开启某些非正式发布的特性，仅用于POC验证，例如GDS表关联操作。这些特性属于延伸特性，建议客户谨慎开启，在某些功能场景下可能存在问题。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 取值范围：布尔型 on表示开启这些功能受限的特性，保持前向兼容。但某些场景可能存在功能上的问题。 off表示禁止使用这些特性。 默认值：off

synchronize_seqscans 参数说明：控制启动同步的顺序扫描。在大约相同的时间内并行扫描读取相同的数据块，共享I/O负载。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 取值范围：布尔型 on表示扫描可能从表的中间开始，然后选择"环绕"方式来覆盖所有的行，为了与已经在进行中的扫描活动同步。这可能会造成没有用ORDER BY子句的查询得到行排序造成不可预测的后果。 off表示确保顺序扫描是从表头开始的。 默认值：on

backslash_quote 参数说明：控制字符串文本中的单引号是否能够用\'表示。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 在字符串文本符合SQL标准的情况下，\没有任何其他含义。这个参数影响的是如何处理不符合标准的字符串文本，包括明确的字符串转义语法是（E'...'）。 取值范围：枚举类型 on表示一直允许使用\'表示。 off表示拒绝使用\'表示。 safe_encoding表示仅在客户端字符集编码不会在多字节字符末尾包含\的ASCII值时允许。 默认值：safe_encoding

hadr_max_size_for_xlog_receiver 参数说明：该参数为异地容灾参数，表示灾备集群中实例获取obs端日志和本地回放日志的最大允许差距，若差距大于此值时停止获取obs端日志。 该参数属于SIGHUP类型参数，请参考表2中方式对应设置方法进行设置。 修改建议：该参数的取值应和本地磁盘大小相关，建议设置为磁盘大小的50%。 取值范围：整型，0~2147483647‬，单位为KB。 默认值：256GB

pooler_cancel_timeout 参数说明：CN连接池在错误处理时Cancel某连接的超时时间。如果在子事务或存储过程异常捕获的过程中发生该类超时，那么包含子事务或存储过程的整个事务将发生回滚。在此基础上，在子事务或存储过程异常捕获的过程中，如果错误源自COPY FROM操作中源数据与目标表表结构的不一致，则只要该参数值不为0，就总会触发超时报错。 该参数属于SIGHUP类型参数，请参考表2中对应设置方法进行设置。 取值范围：整型，最小值为0，最大值为7200，最小单位为秒。其中0时（一般不建议）表示关闭此开关，不做超时限制。 默认值：15s

pooler_connect_max_loops 参数说明：pooler建链重试功能使用，主备切换场景增强建链稳定性，若节点间pooler建链失败会跟备机重试建连，此时若恰好备机升主机成功，则可以在重试阶段建链成功。该参数可以设置重试总轮数，增强建链稳定性。当参数设置为0时，可以关闭重试功能，业务只跟主机建链而不跟备机重试。 该参数属于USERSET类型参数，请参考表2中对应设置方法进行设置。 取值范围：整型，最小值为0，最大值为20。 默认值：1

pooler_connect_interval_time 参数说明：pooler建链重试功能使用，当参数pooler_connect_max_loops设置大于1时，该参数可以控制不同重试轮数之间执行时间间隔。参数设置方面，建议略大于当前集群主备切换恢复时间即。 该参数属于USERSET类型参数，请参考表2中对应设置方法进行设置。 取值范围：整型，最小值为0，最大值为7200，最小单位为秒。 默认值：15s

pooler_port 参数说明：cm_agent、cm_ctl等内部工具运维管理端口，初始化用户或系统管理员通过客户端连接数据库所使用端口。 该参数属于POSTMASTER类型参数，请参考表2中对应设置方法进行设置。 取值范围：CN或DN实例的GUC参数"port"值加1。 默认值：CN或DN实例的GUC参数"port"默认值加1，CN实例该参数默认值为8001，DN实例该参数默认值为40001。

max_pool_size 参数说明：CN的连接池与其它某个CN/DN的最大连接数。 该参数属于POSTMASTER类型参数，请参考表2中对应设置方法进行设置。 取值范围：整型，1~65535 默认值： 独立部署： 32768（60核CPU/480G内存）；16384（32核CPU/256G内存）；8192（16核CPU/128G内存）；4096（8核CPU/64G内存）；2048（4核CPU/32G内存）；1000（4核CPU/16G内存） 金融版（标准型）： CN：32000（196核CPU/1536G内存，128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存，96核CPU/768G内存，80核CPU/640G内存）；16000（72核CPU/576G内存，64核CPU/512G内存，60核CPU/480G内存）；8000（32核CPU/256G内存）；4000（16核CPU/128G内存）；2000（8核CPU/64G内存） DN：50000（196核CPU/1536G内存，128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存，96核CPU/768G内存，80核CPU/640G内存）；16000（72核CPU/576G内存，64核CPU/512G内存，60核CPU/480G内存）；8000（32核CPU/256G内存）；4000（16核CPU/128G内存）；2000（8核CPU/64G内存） 企业版： CN：10000（196核CPU/1536G内存）；5000（128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存）；4000（96核CPU/768G内存）；3000（80核CPU/640G内存）；2048（80核CPU/512G内存，72核CPU/576G内存，64核CPU/512G内存，60核CPU/480G内存，32核CPU/256G内存）；1024（16核CPU/128G内存，8核CPU/64G内存） DN：20000（196核CPU/1536G内存，128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存）；15000（96核CPU/768G内存，80核CPU/640G内存）；10000（80核CPU/512G内存，72核CPU/576G内存，64核CPU/512G内存，60核CPU/480G内存）；5000（32核CPU/256G内存）；2000（16核CPU/128G内存）；1024（8核CPU/64G内存） 金融版（数据计算型）： CN：10000（196核CPU/1536G内存）；5000（128核CPU/1024G内存）；3000（96核CPU/768G内存）；2048（72核CPU/576G内存，64核CPU/512G内存）；1024（32核CPU/256G内存） DN：2048（196核CPU/1536G内存，128核CPU/1024G内存，96核CPU/768G内存，72核CPU/576G内存，64核CPU/512G内存）；1024（32核CPU/256G内存）

persistent_datanode_connections 参数说明：会话是否会释放获得的连接。 该参数属于BACKEND类型参数，请参考表2中对应设置方法进行设置。 取值范围：布尔型 off表示会释放获得连接。 on表示不会释放获得连接。 打开此开关后，会存在会话持有连接但并未运行查询的情况，导致其他查询申请不到连接报错。出现此问题时，需约束会话数量小于等于max_active_statements。 默认值：off

audit_login_logout 参数说明：这个参数决定是否审计用户的登录（包括登录成功和登录失败）、注销。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：整型，0~7。 0表示关闭用户登录、注销审计功能。 1表示只审计用户登录成功。 2表示只审计用户登录失败。 3表示只审计用户登录成功和失败。 4表示只审计用户注销。 5表示只审计用户注销和登录成功。 6表示只审计用户注销和登录失败。 7表示审计用户登录成功、失败和注销。 默认值：7

no_audit_client 参数说明：该参数用于配置不需要审计的客户端名称及IP地址列表。参数格式为：客户端名称@IP，同pg_query_audit函数中的client_conninfo字段，例如“cm_agent@127.0.0.1, gs_clean@127.0.0.1”。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：字符串，多个配置项需使用逗号分隔。 默认值：空字符串 当执行的SQL语句同时满足full_audit_users和no_audit_client参数配置时，以no_audit_client配置优先，不记录审计日志。 数据库服务端内部工具或节点之间通信也会产生审计日志，针对这些风险较低的审计场景的可以通过配置no_audit_client参数不记录审计，以节约审计日志占用空间，提升审计日志查询性能。

enable_twophase_commit 参数说明：当前云数据库主要解决SDS替换问题，采用模式为GTM Free，为防止业务滥用导致不可靠问题，提供guc参数开关enable_twophase_commit禁用分布式写事务，该参数属于USERSET类型参数，请参考表2中对应设置方法进行设置。 取值范围：布尔型 on表示开启GTM-FREE模式下，允许业务进行分布式两阶段写事务。 off表示开启GTM-FREE模式下，禁止业务进行分布式两阶段写事务。 默认值：on

application_type 参数说明：此参数仅在enable_gtm_free为on时有效。此参数用来说明用户的业务类型。该参数属于USERSET类型参数，请参考表2中对应设置方法进行设置。此参数不允许使用gs_guc设置，只允许以下列两种方式设置： 使用gsql等客户端在session级别设置。 使用jdbc连接数据库时，给连接字符串指定ApplicationType参数。 取值范围：枚举类型 not_perfect_sharding_type表示跨节点的业务。取此值时，允许执行跨节点的语句。 perfect_sharding_type表示单节点的业务。取此值时，如果SQL语句需要多个节点参与，会直接报错。对应的SQL语句会同时打印到系统日志中。 取此值时，使用/*+ multinode */ hint可以显示允许SQL语句在多个节点执行。multinode hint可以加到select、insert、update、delete、merge关键字之后。

enable_defer_calculate_snapshot 参数说明：延迟计算快照的xmin和oldestxmin，执行1000个事务或者间隔1s才触发计算，设置为on时可以在高负载场景下减少计算快照的开销，但是会导致oldestxmin推进较慢，影响垃圾元组回收，设置为off时xmin和oldestxmin可以实时推进，但是会增加计算快照时的开销。 该参数属于SIGHUP类型参数，请参考表2中对应设置方法进行设置。 取值范围：布尔型。 on表示延迟计算快照xmin和oldestxmin。 off表示实时计算快照xmin和oldestxmin。 默认值：on。

enable_gtm_free 参数说明：大并发场景下同一时刻存在活跃事务较多，GTM下发的快照变大且快照请求变多的情况下，瓶颈卡在GTM与CN通讯的网络上。为消除该瓶颈，引入GTM-FREE模式。取消CN和GTM的交互，取消CN下发GTM获取的事务信息给DN。CN只向各个DN发送query，各个DN由本地产生快照及xid等信息，开启该参数支持分布式事务读最终一致性，即分布式事务只有写外部一致性，不具有读外部一致性。 该参数属于POSTMASTER类型参数，请参考表2中对应设置方法进行设置。 业务使用GTM-Free模式时，建议将application_type设置成perfect_sharding_type，以便及时发现可能导致数据不一致的SQL语句。否则，系统不会拦截可能导致数据不一致的语句，造成数据不一致。 取值范围：布尔型 on表示开启GTM-FREE模式，集群状态为读最终一致性。 off表示非GTM-FREE模式。 默认值：off

pgxc_node_name 参数说明：指定节点名称。 该参数属于POSTMASTER类型参数，请参考表2中对应设置方法进行设置。 在备机请求主机进行日志复制时，如果application_name参数没有被设置，那么pgxc_node_name参数会被用来作为备机在主机上的流复制槽名字。该流复制槽的命名方式为 "该参数值_备机ip_备机port"。其中，备机ip和备机port取自replconninfo参数中指定的备机ip和端口号。该流复制槽最大长度为61个字符，如果拼接后的字符串超过该长度，则会使用截断后的pgxc_node_name进行拼接，以保证流复制槽名字长度小于等于61个字符。 此参数修改后会导致连接集群失败，不建议进行修改。 取值范围：字符串。 默认值：当前节点名称。

transaction_isolation 参数说明：设置当前事务的隔离级别。 该参数属于USERSET类型参数，请参考表2中对应设置方法进行设置。 取值范围：字符串，只识别以下字符串，大小写空格敏感： serializable：GaussDB中等价于REPEATABLE READ。 read committed：只能读取已提交的事务的数据（缺省），不能读取到未提交的数据。 repeatable read：仅能读取事务开始之前提交的数据，不能读取未提交的数据以及在事务执行期间由其它并发事务提交的修改。 read uncommitted：读未提交，可以读取任何时刻的数据。 default：设置为defualt_transaction_isolation所设隔离级别。 默认值：read committed