华为云用户手册

audit_thread_num 参数说明：审计线程的个数。 该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 取值范围：整型，1~48 默认值：1 当audit_dml_state开关打开且在高性能场景下，建议增大此参数保证审计消息可以被及时处理和记录。 请保证此参数不大于审计目录下审计文件个数的最大值audit_file_remain_threshold，否则会导致审计功能无法正常使用与数据库异常。

audit_space_limit 参数说明：审计文件占用的磁盘空间总量。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：整型，1024KB~1024GB，单位为KB。 默认值：1GB 多审计线程场景下，审计文件占用的磁盘空间最小值是audit_thread_num与audit_rotation_size的乘积，请保证audit_space_limit的值大于audit_thread_num与audit_rotation_size的乘积。

audit_directory 参数说明：审计文件的存储目录。一个相对于数据目录data的路径，可自行指定，仅sysadmin用户可以访问。 该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 取值范围：字符串 默认值：pg_audit。如果使用om工具部署数据库，则审计日志路径为“$GAUSS LOG /pg_audit/实例名称”。 不同的DN实例需要设置不同的审计文件存储目录，否则会导致审计日志异常。 当配置文件中audit_directory的值为非法路径时，会导致审计功能无法使用。

audit_rotation_interval 参数说明：指定创建一个新审计日志文件的时间间隔。当现在的时间减去上次创建一个审计日志的时间超过了此参数值时，服务器将生成一个新的审计日志文件。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：整型，1~INT_MAX/60，单位为min。 默认值：1d 请不要随意调整此参数，否则可能会导致audit_resource_policy无法生效，如果需要控制审计日志的存储空间和时间，请使用audit_resource_policy、audit_space_limit和audit_file_remain_time参数进行控制。

audit_rotation_size 参数说明：指定审计日志文件的最大容量。当审计日志消息的总量超过此参数值时，服务器将生成一个新的审计日志文件。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：整型，1024~1048576，单位为KB。 默认值：10MB 请不要随意调整此参数，否则可能会导致audit_resource_policy无法生效，如果需要控制审计日志的存储空间和时间，请使用audit_resource_policy、audit_space_limit和audit_file_remain_time参数进行控制。 审计日志文件中记录的单条日志占用空间大小超过此参数值时会被作为无效日志文件。

numa_distribute_mode 参数说明：用于控制部分共享数据和线程在NUMA节点间分布的属性。用于大型多NUMA节点的ARM服务器性能调优，一般不用设置。 该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 取值范围：字符串，当前有效取值为'none', 'all'。 none： 表示不启用本特性。 all：表示将部分共享数据和线程分布到不同的NUMA节点下，减少远端访存次数，提高性能。目前仅适用于拥有多个NUMA节点的ARM服务器，并且要求全部NUMA节点都可用于数据库进程，不支持仅选择一部分NUMA节点。 当前版本x86架构下不支持numa_distribute_mode设置为all。 默认值：'none'

advance_xlog_file_num 参数说明：用于控制在后台周期性地提前初始化xLog文件的数目。该参数是为了避免事务提交时执行xLog文件初始化影响性能，但仅在超重负载时才可能出现，因此一般不用配置。 该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 取值范围：整型，0~1000000（0表示不提前初始化）。例如，取值10，表示后台线程会周期性地根据当前xLog写入位置提前初始化10个xLog文件。 默认值：0

string_hash_compatible 参数说明：该参数用来说明char类型和varchar/text类型的hash值计算方式是否相同，以此来判断进行分布列从char类型到相同值的varchar/text类型转换，数据分布变化时，是否需要进行重分布。 该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 取值范围：布尔型 on表示计算方式相同，不需要进行重分布。 off表示计算方式不同，需要进行重分布。 计算方式的不同主要体现在字符串计算hash值时传入的字节长度上。（如果为char，则会忽略字符串后面空格的长度，如果为text或varchar，则会保留字符串后面空格的长度。）hash值的计算会影响到查询的计算结果，因此此参数一旦设置后，在整个数据库使用过程中不能再对其进行修改，以避免查询错误。 默认值：off

ustore_attr 参数说明：该参数主要用来控制USTORE存储引擎表的信息统计，回滚类型，重点模块(包括数据、索引、回滚段、回放等)运行时数据的校验，主要用于协助研发问题定位。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 取值范围：字符串，该参数值的设置方式采用key-value模式，key和value取值对应关系和说明如下。如果是多个key-value组合设置，中间使用";"作为分隔符，例如： ustore_attr='ustore_verify_level=NORMAL;ustore_verify_module=UPAGE:UBTREE:UNDO:REDO'。 ustore_attr设置参数值时，key和value之间的"="前后不要有空格或者其他字符，例如ustore_attr='ustore_verify_level = NORMAL;，内核代码校验会发现参数不合法，导致参数设置失败。 ustore_verify_level：控制校验的级别。 取值范围：字符串，见下述表格详细描述。 表1 ustore_verify_level取值含义说明 参数取值 含义 FAST FAST表示快速校验，校验内容少，性能影响最小。 NORMAL NORMAL表示正常校验，校验内容相比快速校验增多，性能影响中等。 SLOW SLOW表示慢速校验，校验内容最多，性能影响比较大。 默认值：空字符串 ustore_verify_module：控制校验的模块。 取值范围：字符串，设置值UPAGE，UBTREE，UNDO, REDO中的一个或者多个，或者单独设置ALL或者NULL(不区分大小写)。当设置 UPAGE，UBTREE，UNDO，REDO中的多个值时，使用":"作为连接符。例如ustore_verify_module=UPAGE:UBTREE:UNDO:REDO。 表2 ustore_verify_module取值含义说明 参数取值 含义 UPAGE 表示开启数据页面校验 UBTREE 表示开启UBTREE索引校验 UNDO 表示开启回滚段数据校验 REDO 表示开启REDO流程的数据页面校验 ALL 表示同时开启UPAGE，UBTREE，UNDO，REDO模块数据的校验 NULL 表示同时关闭UPAGE，UBTREE，UNDO，REDO模块数据的校验 默认值：空字符串 index_trace_level：控制开启索引追踪并控制打印级别，开启后在索引扫描的过程中，会根据不同的打印级别对符合条件的索引元组的信息进行打印。 取值范围：字符串，取值下表格描述。 默认值：NO 表3 index_trace_level取值含义说明 参数取值 含义 NO 不打印任何额外信息。 NORMAL 打印可见索引元组相关信息，包括： 当前索引元组所在索引页面号以及偏移。 当前元组状态。 当前元组对应的TID以及partOid。 当前元组对应的xmin和xmax信息。 当前元组内容（如果开启enable_log_tuple）。 VISIBILITY 在NORMAL的基础上，额外打印没有通过可见性检查的索引元组的信息，并标明是否可见。 SHOWHIKEY 在VISIBILITY的基础上，尝试打印页面上HIKEY元组的信息。 ALL 打印扫描的索引页面上所有元组的相关信息。 enable_log_tuple：打印日志级提示信息时，是否允许同时将相关元组的内容打印出来，以便进行问题排查和定位。 取值范围：on或者off（不区分大小写） 默认值：off 备注：该参数已弃用 enable_ustore_sync_rollback：控制USTORE表是否开启同步回滚。 取值范围：布尔值 默认值：true enable_ustore_async_rollback：控制USTORE表是否开启异步回滚。 取值范围：布尔值 默认值：true enable_ustore_page_rollback：控制USTORE表是否开启页面回滚。 取值范围：布尔值 默认值：true enable_ustore_partial_seqscan：是否允许USTORE表开启部分扫描。 取值范围：布尔值 默认值：false enable_candidate_buf_usage_count：是否开启缓存区使用计数统计。 取值范围：布尔值 默认值：false ustats_tracker_naptime：控制USTORE表统计信息周期。 取值范围：1~INT_MAX/1000 默认值：20, 单位(秒) umax_search_length_for_prune：控制USTORE表prune操作搜索的最大深度。 取值范围：1~INT_MAX/1000 默认值：10，单次(次) 默认值：空字符串 该参数只适用于集中式上的USTORE存储引擎表。

allow_create_sysobject 参数说明：设置是否允许在系统模式下创建或修改函数、存储过程、同义词、聚合函数、操作符等对象。此处的系统模式指数据库初始后自带的模式，但不包含public模式。系统模式的oid通常小于16384。 该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 取值范围：布尔型 on表示允许初始用户和系统管理员在系统模式下创建或修改函数、存储过程、同义词、聚合函数等对象，并允许初始用户在系统模式下创建操作符。其他用户是否允许创建这些对象请参考对应模式的权限要求。 off表示禁止所有用户在系统模式下创建或修改函数、存储过程、同义词、聚合函数、操作符等对象。 默认值：on

post_auth_delay 参数说明：在认证成功后，延迟指定时间，启动服务器连接。允许调试器附加到启动进程上。 该参数属于BACKEND类型参数，请参考表1中对应设置方法进行设置。 取值范围：整型，最小值为0，最大值为2147，单位为秒。 默认值：0 此参数只用于调试和问题定位，为避免影响正常业务运行，生产环境下请确保参数值为默认值0。参数设置为非0时可能会因认证延迟时间过长导致数据库实例状态异常。

allow_system_table_mods 参数说明：设置是否允许修改系统表的结构或系统自带模式名称。 该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 取值范围：布尔型 on表示允许修改系统表的结构或系统自带模式名称。 off表示不允许修改系统表的结构或系统自带模式名称。 默认值：off 不建议修改该参数默认值，若设置为on，可能导致系统表损坏，甚至数据库无法启动。

debug_assertions 参数说明：控制打开各种断言检查。能够协助调试，当遇到奇怪的问题或者崩溃，请把此参数打开，因为它能暴露编程的错误。要使用这个参数，必须在编译 GaussDB 的时候定义宏USE_ASSERT_CHECKING（通过configure选项 --enable-cassert完成）。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 取值范围：布尔型 on表示打开断言检查。 off表示不打开断言检查。 当启用断言选项编译GaussDB时，debug_assertions缺省值为on 。 默认值：off

enable_fast_numeric 参数说明：标识是否开启Numeric类型数据运算优化。Numeric数据运算是较为耗时的操作之一，通过将Numeric转化为int64/int128类型，提高Numeric运算的性能。 该参数属于SUSET类型参数，请参考表1中对应设置方法进行设置。 取值范围：布尔型 on/true表示开启Numeric优化。 off/false表示关闭Numeric优化。 默认值：on

trace_recovery_messages 参数说明：启用恢复相关调试输出的日志录，否则将不会被记录。该参数允许覆盖正常设置的log_min_messages，但是仅限于特定的消息，这是为了在调试备机中使用。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：枚举类型，有效值有debug5、debug4、debug3、debug2、debug1、log，取值的详细信息请参见log_min_messages。 默认值：log 默认值log表示不影响记录决策。 除默认值外，其他值会导致优先级更高的恢复相关调试信息被记录，因为它们有log优先权。对于常见的log_min_messages设置，这会导致无条件地将它们记录到服务器日志上。

zero_damaged_pages 参数说明：控制检测导致GaussDB报告错误的损坏的页头，终止当前事务。 该参数属于SUSET类型参数，请参考表1中对应设置方法进行设置。 取值范围：布尔型 设置为on时，会导致系统报告一个警告，把损坏的页面填充为零然后继续处理。这种行为会破坏数据，也就是所有在已经损坏页面上的行记录。但是它允许绕开坏页面然后从表中尚存的未损坏页面上继续检索数据行。因此它在因为硬件或者软件错误导致的崩溃中进行恢复是很有用的。通常不应该把它设置为on，除非不需要从崩溃的页面中恢复数据。 默认值：off

hadr_process_type 参数说明：流式容灾双实例容灾场景流程标识。 该参数属于SIGHUP类型参数，改请参考表2进行设置。 取值范围：枚举类型。 none表示当前无流程。 failover表示当前处于灾备数据库实例升主流程。 switchover_promote表示主备数据库实例倒换流程中灾备数据库实例升主流程。 switchover_demote表示主备数据库实例倒换流程中主数据库实例降为灾备数据库实例流程。 默认值：none

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

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

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

transaction_deferrable 参数说明：指定是否允许一个只读串行事务延迟执行，使其不会执行失败。该参数设置为on时，当一个只读事务发现读取的元组正在被其他事务修改，则延迟该只读事务直到其他事务修改完成。该参数为预留参数，该版本不生效。与该参数类似的还有一个default_transaction_deferrable，设置它来指定一个事务是否允许延迟。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 取值范围：布尔型 on表示允许执行。 off表示不允许执行。 默认值：off

omit_encoding_error 参数说明：设置为on，数据库的客户端字符集编码为UTF-8时，出现的字符编码转换错误将打印在日志中，有转换错误的被转换字符会被忽略，以"?"代替。 该参数属于USERSET类型参数，请参考表2中对应设置方法进行设置。 取值范围：布尔型 on表示有转换错误的字符将被忽略，以"?"代替，打印错误信息到日志中。 off表示有转换错误的字符不能被转换，打印错误信息到终端。 默认值：off

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

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

td_compatible_truncation 参数说明：控制是否开启与Teradata数据库相应兼容的特征。该参数在用户连接上与TD兼容的数据库时，可以将参数设置成为on（即超长字符串自动截断功能启用），该功能启用后，在后续的insert语句中，对目标表中char和varchar类型的列插入超长字符串时，会按照目标表中相应列定义的最大长度对超长字符串进行自动截断。保证数据都能插入目标表中，而不是报错。 超长字符串自动截断功能不适用于insert语句包含外表的场景。 如果向字符集为字节类型编码（SQL_ASCII、LATIN1等）的数据库中插入多字节字符数据（如汉字等），且字符数据跨越截断位置，这种情况下，按照字节长度自动截断，自动截断后会在尾部产生非预期结果。如果用户有对于截断结果正确性的要求，建议用户采用UTF8等能够按照字符截断的输入字符集作为数据库的编码集。 该参数属于USERSET类型参数，请参考表2中对应设置方法进行设置。 取值范围：布尔型 on表示启动超长字符串自动截断功能。 off表示停止超长字符串自动截断功能。 默认值：off

sql_compatibility 参数说明：控制数据库的SQL语法和语句行为同哪一个主流数据库兼容。该参数属于INTERNAL类型参数，用户无法修改，只能查看。 取值范围：枚举型 A表示同O数据库兼容。 B表示同MY数据库兼容。 C表示同TD数据库兼容。 PG表示同POSTGRES数据库兼容。 默认值：A 该参数只能在执行CREATE DATABASE命令创建数据库的时候设置。 在数据库中，该参数只能是确定的一个值，要么始终设置为A，要么始终设置为B，请勿任意改动，否则会导致数据库行为不一致。

plpgsql.variable_conflict 参数说明：设置同名的存储过程变量和表的列的使用优先级。 该参数属于USERSET类型参数，仅支持表2中对应设置方法3进行设置。 取值范围：字符串 error表示遇到存储过程变量和表的列名同名则编译报错。 use_variable表示存储过程变量和表的列名同名则优先使用变量。 use_column表示存储过程变量和表的列名同名则优先使用列名。 默认值：error

transform_null_equals 参数说明：控制表达式expr = NULL（或NULL = expr）当做expr IS NULL处理。如果expr得出NULL值则返回真，否则返回假。 正确的SQL标准兼容的expr = NULL总是返回NULL（未知）。 Microsoft Access里的过滤表单生成的查询使用expr = NULL来测试空值。打开这个选项，可以使用该接口来访问数据库。 该参数属于USERSET类型参数，请参考表2中对应设置方法进行设置。 取值范围：布尔型 on表示控制表达式expr = NULL（或NULL = expr）当做expr IS NULL处理。 off表示不控制，即expr = NULL总是返回NULL（未知）。 默认值：off 新用户经常在涉及NULL的表达式上语义混淆，故默认值设为off。

plsql_compile_check_options 参数说明：数据库兼容性行为配置项，该参数的值由若干个配置项用逗号隔开构成。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 取值范围：字符串 默认值："" 当前只支持表1。 配置多个兼容性配置项时，相邻配置项用逗号隔开，例如：set plsql_compile_check_options='for_loop,outparam';

a_format_dev_version 参数说明：数据库平台迭代小版本兼容性行为配置项，该参数的值为字符串枚举值。 该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 取值范围：字符串 默认值："" 当前只支持表1。 兼容性配置项时设置字符串，例如：set a_format_dev_version='s1'; 表4 兼容性配置项 兼容性配置项 兼容性行为控制 s1 开启参数后cast支持 text转int四舍五入。