GUC参数说明

本文档介绍了Vastbase G100 V2.2 Build 11版本相对比V2.2 Build 10版本的参数变更，包括新增参数、内容有变更参数、移除参数。

新增参数

allow_create_sysobject

参数说明： 设置是否允许在系统模式下创建或修改函数、存储过程、同义词等对象。此处的系统模式指数据库初始后自带的模式，但不包含public模式。

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

取值范围： 布尔型

• on：表示允许初始用户和系统管理员在系统模式下创建或修改函数、存储过程、同义词等对象。其他用户是否允许创建这些对象请参考对应模式的权限要求。
• off：表示禁止所有用户在系统模式下创建或修改函数、存储过程、同义词等对象。

默认值： on

block_encryption_mode

参数说明： 控制基于块算法(如AES)的块加密模式。

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

取值范围： 枚举类型，有效值如下：

• aes-128-cbc
• aes-192-cbc
• aes-256-cbc
• aes-128-cfb1
• aes-192-cfb1
• aes-256-cfb1
• aes-128-cfb8
• aes-192-cfb8
• aes-256-cfb8
• aes-128-cfb128
• aes-192-cfb128
• aes-256-cfb128
• aes-128-ofb
• aes-192-ofb
• aes-256-ofb

其中aes表示加/解密算法，128/192/256表示密钥长度（单位：bit），cbc/cfb1/cfb8/cfb128/ofb表示块加/解密模式。

默认值： aes-128-cbc

resilience_threadpool_reject_cond

参数说明： 用于控制线程池过载逃生的堆积会话数占比。该参数仅在GUC参数use_workload_manager和enable_thread_pool打开时生效。

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

取值范围： 字符串，长度大于0

该参数分为recover_threadpool_percent、overload_threadpool_percent两部分，这两个部分的具体含义如下：

• recover_threadpool_percent：线程池恢复正常状态的接入会话占线程池初始设置线程数的百分比，当已经接入的会话数小于线程池初始设置数乘以该值对应的百分比后，停止过载逃生并放开新连接接入，取值为0~INT_MAX，设置为多少表示百分之多少。
• overload_threadpool_percent：线程池过载时的接入会话占线程池初始设置线程数的百分比，当已经接入的会话数大于线程池初始设置数乘以该值对应的百分比后，表示当前线程池已经过载，触发过载逃生kill会话并禁止新连接接入，取值为0~INT_MAX，设置为多少表示百分之多少。

默认值： '0,0'，表示关闭线程池逃生功能。

示例：

resilience_threadpool_reject_cond = '100,200'

上述设置表示已经堆积的会话数超过线程池初始设置的线程数的200%后禁止新连接接入并kill堆积的会话，kill会话过程中会话数恢复到线程池初始设置的线程数的100%以下时停止kill会话并允许新连接接入。

• 已经堆积的会话数可以通过查询pg_stat_activity视图有多少条数据获得，需要过滤少量后台线程。线程池设置的初始线程池线程数目可以通过查询thread_pool_attr参数获得。
• 该参数如果设置的百分比过小，则会频繁触发线程池过载逃生流程，会使正在执行的会话被强制退出，新连接短时间接入失败，因此需要根据实际线程池使用情况慎重设置。

sql_ignore_strategy

参数说明： 在MySQL兼容模式下，该参数可控制ignore_error的hint在违反非空约束时的处理策略。其他相关内容可参考INSERT IGNORE。

该功能仅在数据库兼容模式为MySQL时能够使用（即创建DB时DBCOMPATIBILITY='B'），在其他数据库兼容模式下不能使用该特性。

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

取值范围： 枚举类型

• ignore_null: 忽略违反非空约束的行的处理，并继续执行剩余数据库操作。

• overwrite_null: 将违反约束的null值覆写为目标类型的默认值，并继续执行剩余数据库操作。

默认值： ignore_null

resilience_memory_reject_percent

参数说明： 用于控制内存过载逃生的动态内存占用百分比。该参数仅在GUC参数use_workload_manager和enable_memory_limit打开时生效。

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

取值范围： 字符串，长度大于0

该参数分为recover_memory_percent,overload_memory_percent 两部分，这两个部分的具体含义如下：

• recover_memory_percent：内存从过载状态恢复正常状态的动态内存使用占最大动态内存的百分比，当动态内存使用小于最大动态内存乘以该值对应的百分比后，停止过载逃生并放开新连接接入，取值为0~100，设置为多少表示百分之多少。
• overload_memory_percent：内存过载时动态内存使用占最大动态内存的百分比，当动态内存使用大于最大动态内存乘以该值对应的百分比后，表示当前内存已经过载，触发过载逃生kill会话并禁止新连接接入，取值为0~100，设置为多少表示百分之多少。

默认值： '0,0'，表示关闭内存过载逃生功能。

示例：

resilience_memory_reject_percent = '70,90'

上述设置表示内存使用超过最大内存上限的90%后禁止新连接接入并kill堆积的会话，kill会话过程中内存恢复到最大内存的70%以下时停止kill会话并允许新连接接入。

• 最大动态内存和已使用的动态内存可以通过gs_total_memory_detail视图查询获得，最大动态内存：max_dynamic_memory，已使用的动态内存：dynamic_used_memory。
• 该参数如果设置的百分比过小，则会频繁触发内存过载逃生流程，会使正在执行的会话被强制退出，新连接短时间接入失败，需要根据实际内存使用情况慎重设置。

repl_auth_mode

参数说明： 设置主备复制和备机重建的验证模式。

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

• 如果主机上开启了UUID验证功能、且配置了非空字符串的repl_uuid验证码，那么备机也需要开启UUID验证功能、且配置相同的repl_uuid验证码，否则主备日志复制和备机重建请求将被主机拒绝。
• 该参数支持SIGHUP动态加载新值。修改之后，不影响已建连的主备连接，对后续主备复制请求和主备重建请求生效。
• 支持Quorum、DCF协议下的备机重建验证；支持Quorum协议下的主备复制验证；不支持DCF协议下的主备复制验证。
• UUID验证功能主要为了防止主、备误连导致的数据串扰和污染，不是用于安全目的。
• 该参数不支持主、备间自动同步。

取值范围： 枚举类型

• off：表示关闭UUID验证功能。
• default：表示关闭UUID验证功能。
• uuid：表示开启UUID验证功能。

默认值： default

repl_uuid

参数说明： 设置用于主备UUID验证的UUID码。

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

• 如果主机上开启了UUID验证功能、且配置了非空字符串的repl_uuid验证码，那么备机也需要开启UUID验证功能、且配置相同的repl_uuid验证码，否则主备日志复制和备机重建请求将被主机拒绝。
• 该参数支持SIGHUP动态加载新值。修改之后，不影响已建连的主备连接，对后续主备复制请求和主备重建请求生效。
• 支持Quorum、DCF协议下的备机重建验证；支持Quorum协议下的主备复制验证；不支持DCF协议下的主备复制验证。
• UUID验证功能主要为了防止主、备误连导致的数据串扰和污染，不是用于安全目的。
• 该参数不支持主、备间自动同步。

取值范围： 字符串类型。长度0 – 63个字符，字母和数字的组合，大小写不敏感，内部统一转换为小写存储。空字符串表示不启用UUID验证功能。

默认值： 空字符串

result_case_mode

参数说明： 用于控制返回字段名的大小写。

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

• 该功能仅在数据库兼容模式为Oracle时能够使用（即创建DB时DBCOMPATIBILITY='A'），在其他数据库兼容模式下不能使用该特性。
• 该参数只影响返回字段名的大小写形式，不影响Vastbase原有的大小写匹配逻辑。
• 不支持在postgresql.conf文件中配置该参数，可能导致严重问题，仅支持在会话中配置。

取值范围： 枚举类型

• lower：参数初始化取值，未使用引号指定的字段名及别名返回纯小写形式，否则返回引号指定形式。
• upper：未使用引号指定的字段名及别名返回纯大写形式，否则返回引号指定形式。

默认值： lower

tcp_user_timeout

参数说明： 在支持TCP_USER_TIMEOUT套接字选项的操作系统上，指定传输的数据在TCP连接被强制关闭连接之前，指定传输的数据可以保持未确认状态的最大时长。

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

取值范围： 0 ~ 3600000，单位ms

默认值： 0

enable_gtt_concurrent_truncate

参数说明： 是否支持全局临时表truncate table和DML的并发执行，以及全局临时表truncate table和普通表的truncate table的并发执行。

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

取值范围： 布尔型

• on：表示支持上述操作并发。

• off：表示不支持上述操作并发。

默认值： on

dcf_majority_groups

参数说明： DCF策略化多数派功能设置。对于需要配置此参数的group，该group内至少有一台备机收到日志。即该group内存在一台同步备机。若对DCF实例内做了增删节点或者对实例内节点group值进行了调整修改，需同步修改此配置。

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

取值范围： 字符串

• 关闭：”“，空字符串表示策略化多数派功能关闭。
• 开启： 配置有效的group值，使用逗号分隔，group值需在dcf_config中存在。例如将group值分别为1和2，加入DCF的策略化多数派配置时，可以设置为"1,2"；若配置了dcf_config中不存在的group值或者其他字符，DCF将认为该配置的group无效。

默认值： 空字符串

若配置了参数后某一group内所有节点均故障，在对其中某个节点做涉及节点build相关操作（节点修复、不换ip的节点替换）时，需要将该group从此参数列表中移除，待节点恢复正常后可将该group再次配置到此参数。

partition_iterator_elimination

参数说明： 控制分区表在分区剪枝结果为一个分区时，是否通过消除分区迭代算子来提升执行效率。

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

取值范围： 布尔型

• on：表示消除分区迭代算子。
• off：表示不消除分区迭代算子。

默认值： off

enable_functional_dependency

参数说明： 控制ANALYZE生成的多列统计信息是否包含函数依赖统计信息，是否应用函数依赖统计信息计算选择率。如果关闭该参数，每组多列统计信息最多支持32列；开启该参数则每组多列统计信息最多支持4列。

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

取值范围： 布尔型

• on包含两个功能：

  • 执行ANALYZE生成的多列统计信息包含函数依赖统计信息。
  • 计算选择率会使用函数依赖统计信息。

• off包含两个功能：

  • 执行ANALYZE生成的多列统计信息不包含函数依赖统计信息。
  • 计算选择率不会使用函数依赖统计信息。

默认值： off

max_logical_replication_workers

参数说明： 订阅端apply worker线程的最大数量。

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

取值范围： 0 ~ 262143

默认值： 4

max_sync_workers_per_subscription

参数说明： 订阅端每个订阅的tablesync worker线程的最大数量。

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

取值范围： 0 ~ 262143

默认值： 2

partition_page_estimation

参数说明： 分区表页面是否通过剪枝结果进行页面估算优化。只包括分区表和local索引页面，不包括全局索引页面。估算公式为：估算后页面 = 分区表总页面数 * （剪枝后分区数/总分区数）

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

取值范围： 布尔型

• on：表示使用剪枝结果进行页面估算优化。
• off：表示不使用剪枝结果进行页面估算优化。

默认值： off

logical_decode_options_default

参数说明： 指定逻辑解码启动时未指定解码选项的全局默认值。

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

当前支持指定的逻辑解码选项包括：parallel-decode-num, parallel-queue-size, max-txn-in-memory, max-reorderbuffer-in-memory。

• parallel-decode-num：指定并行解码的decoder线程数量。其取值范围为1~20的int型，取1表示按照原有的串行逻辑进行解码，取其余值即为开启并行解码。默认值为1。当该选项配置为1时，禁止配置解码格式decode-style。
• parallel-queue-size：指定并行逻辑解码线程间进行交互的队列长度。取值范围是[2,1024]，且必须为2的幂数，默认值为128。队列长度和解码过程的内存使用量正相关。
• max-txn-in-memory：指定单个事务解码中间结果缓存的内存阈值，单位为MB，范围[0,100]，默认值为0，表示不管控内存使用。
• max-reorderbuffer-in-memory：指定所有事务解码中间结果缓存的内存阈值，单位为GB，范围[0,100]，默认值为0，表示不管控内存使用。

取值范围： 通过逗号分隔的key=value字符串，例如：'parallel-decode-num=4,parallel-queue-size=128'。其中空字符串表示采用程序硬编码的默认值。

默认值： 空字符串

var_eq_const_selectivity

参数说明： 整型常量选择率是否使用新型选择率模型进行估算。

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

取值范围： 布尔型

• on：表示使用新型选择率模型计算整型常量的选择率：
  • 若整型不落入MCV且不为NULL值，但落入直方图，则利用直方图左右边界情况进行估算。
  • 如果也不落入直方图，则使用表的行数进行估算。
  • 若整型为NULL值或者MCV值，使用原逻辑计算选择率。
• off：表示使用原有的选择率计算模型。

默认值： off

lower_case_table_names

参数说明： 在MySQL兼容模式下，控制表名的大小写敏感特性。具体内容请参考设置表名大小写敏感。

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

• 该功能仅在数据库兼容模式为MySQL时能够使用（即创建DB时DBCOMPATIBILITY='B'），在其他数据库兼容模式下不能使用该特性。
• 创建数据库后，用户无法修改此参数。

取值范围： 0，1

• 0：对象名使用创建时的大小写样式保存，在比较判断时使用大小写敏感的方式。
• 1：对象名统一使用小写样式保存，在比较判断时使用大小写不敏感的方式。

默认值： 0

b_compatibility_mode

参数说明： 该参数是当Vastbase与MySQL语法有相同的内容，而功能有冲突时，区分使用MySQL的功能还是Vastbase的功能，开启该参数则使用MySQL的功能。

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

• 该功能仅在数据库兼容模式为MySQL时能够使用（即创建DB时DBCOMPATIBILITY='B'），在其他数据库兼容模式下不能使用该特性。
• 当前Vastbase开启该参数仅支持将#识别为注释。
  • on：表示使用MySQL的功能，将#标识符识别为注释。
  • off：表示使用Vastbase功能，将#识别为异或。

取值范围： 布尔型

• on：表示使用MySQL功能。
• off：表示使用Vastbase功能。

默认值： off

enable_ai_stats

参数说明： 该参数用于指定是否创建或者使用智能统计信息。

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

取值范围： 布尔型

• on：表示可以创建和使用智能统计信息功能。

• off：表示不可以创建和使用智能统计信息功能。

默认值： on

multi_stats_type

参数说明： 该参数用于指定在enable_ai_stats为on状态下创建的统计信息类别。

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

取值范围：枚举类型，有效值为”BAYESNET”、“MCV”、“ALL”。

• “BAYESNET”：只创建智能统计信息。
• “MCV”：只创建传统统计信息。
• “ALL”：同时创建传统统计信息和智能统计信息。

默认值： “BAYESNET”

enable_cachedplan_mgr

参数说明： 该参数用于指定是否开启自适应计划选择功能。

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

取值范围： 布尔型

• on：表示开启自适应计划选择功能。

• off：表示关闭自适应计划选择功能。

默认值： on

track_stmt_standby_chain_size

参数说明： 组合参数，控制备机快/慢SQL记录的最大占用内存与磁盘空间。以60秒为周期读取该参数，并执行清理超过保留时间的记录，仅sysadmin用户可以访问。

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

取值范围： 字符型

该参数分为四部分，形式为'fast sql memory size, fast sql disk size, slow sql memory size, slow sql disk size' 在主机上，full sql为全量sql，存储在一张unlogged表上，slow sql为其中慢的那部分sql。在备机中我们将非slow的那部分称为fast sql，slow与fast分开存放于不同位置，因此额外使用了四个值进行控制。

• fast sql memory size 为保留的快SQL的最大内存占用空间，取值范围为 [16, 1024]，单位为MB。

• fast sql disk size 为保留的快SQL的最大磁盘占用空间，取值范围为 [512, 1048576]，单位为MB。

• slow sql memory size 为保留的慢SQL的最大内存占用空间，取值范围为 [16, 1024]，单位为MB。

• slow sql disk size 为保留的慢SQL的最大磁盘占用空间，取值范围为 [512, 1048576]，单位为MB。

• 注意其中快慢SQL各自对应的内存值不可大于磁盘值。
• 清理时按照每16M数据的粒度进行清理，因此最大会有16M数据量的延迟误差。

默认值： 32, 1024, 16, 512

memory_trace_level

参数说明：动态内存使用超过最大动态内存的90%后，记录内存申请信息的管控等级。该参数仅在use_workload_manager和enable_memory_limit打开时生效。

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

取值范围：枚举型

• none：表示不记录内存申请信息。

• level1：动态内存使用超过最大动态内存的90%后，会记录以下信息。

  • 全局内存概况。
  • instance，session，thread三种类型的所有内存上下文中内存占用前20的内存上下文的内存使用情况。
  • 每个内存上下文的totalsize、freesize字段。

• level2：动态内存使用超过最大动态内存的90%后，会记录以下信息。

  • 全局内存概况。
  • instance，session，thread三种类型的所有内存上下文中内存占用前20的内存上下文的内存使用情况。
  • 每个内存上下文的totalsize，freesize字段。
  • 每个内存上下文上所有内存申请的详细信息，包含申请内存所在的文件，行号和大小。

默认值：level1

• 该参数设置为level2后，会记录每个内存上下文的内存申请详情（file，line，size字段），会对性能影响较大，需慎重设置。
• 记录的内存快照信息可以通过系统函数gs_get_history_memory_detail(cstring)查询。
• 记录的内存上下文是经过将同一类型所有重名的内存上下文进行汇总之后得到的。

plsql_compile_check_options

参数说明：数据库兼容性行为配置项，该参数的值由若干个配置项用逗号隔开构成。

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

取值范围：字符串

默认值：””

• 当前只支持下表所示的兼容性配置项：

  兼容性配置项	兼容性行为控制
  for_loop	控制存储过程中FOR_LOOP查询语句行为设置此项时，在FOR rec IN query LOOP语句中，若rec已经定义，不会复用已经定义的rec变量，而且重新建立一个新的变量。否则，会复用已经定义的rec变量，不会建立新的变量。(与proc_implicit_for_loop_variable相同，后续进性收编)
  outparam	out重载条件下，有重载函数；将对out出参常量进性检查，禁止out出参为常量报错。

• 配置多个兼容性配置项时，相邻配置项用逗号隔开，例如：set plsql\_compile\_check\_options='for\_loop,outparam';

tcp_user_timeout

参数说明：在支持TCP_USER_TIMEOUT套接字选项的操作系统上，设置Vastbase在发送数据时，指定传输的数据在TCP连接被强制关闭之前可以保持未确认状态的最大时长。

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

• 如果操作系统不支持TCP_USER_TIMEOUT选项，这个参数的值将不生效，默认为0。

• 在通过Unix域套接字进行连接的操作系统上，这个参数将被忽略。

取值范围：0-3600000，单位为ms。其中0表示跟随操作系统设置。

默认值：0

不同操作系统内核下，这个参数生效结果将不同：

• aarch64 EulerOS（Linux内核版本：4.19）：超时时间即为该参数设置值。
• x86 Euler2.5（Linux内核版本：3.10）：超时时间不是该参数设置值，而是不同区间的最大值，即超时时间取值为：tcp_user_timeout设置值所处“Linux TCP重传总耗时”区间的上限最大值。例如：tcp_user_timeout=40000时，重传总耗时为51秒。

表 1 x86 Euler2.5（Linux内核版本：3.10）tcp_user_timeout参数取值示意

enable_set_variable_b_format

参数说明： 该参数用于控制在MySQL数据库模式下是否支持自定义用户变量的功能。

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

取值范围： 布尔型

• on：表示在MySQL数据库模式下支持自定义用户变量。
• off：表示在MySQL数据库模式下不支持自定义用户变量。

默认值： off

pca_shared_buffers

参数说明： 类似于shared_buffers，用于设置页面压缩块地址映射管理buffer的大小。

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

取值范围： 8 ~ 1073741823，单位：kb

默认值： 8kb

enable_seqscan_fusion

参数说明 ：控制是否打开SeqScan优化。

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

取值范围*：布尔型

• on：表示打开SeqScan优化。
• off：表示关闭SeqScan优化。

默认值：off

该参数只能优化EXPLAIN ANALYZE语句的seqscan算子的执行时间。

logical_sender_timeout

参数说明：设置本端等待逻辑日志接收端接收日志的最大等待时间。

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

取值范围：整型， 0 ~ 2147483647，单位为毫秒（ms）。

默认值：30000

参数变更

移除参数

Vastbase G100 V2.2 Build 11相对于V2.2 Build 10版本移除了如下参数：

• replconninfo9
• replconninfo10
• replconninfo11
• replconninfo12
• replconninfo13
• replconninfo14
• replconninfo15
• replconninfo16
• replconninfo17
• replconninfo18
• show_fdw_remote_plan
• last_insert_id_supported
• auto_dop_freeprocs_threshold
• auto_dop_join_threshold
• auto_dop_freeprocs
• auto_dop