华为云用户手册

use_elastic_search 参数说明：使能统一审计发送日志至Elastic Search系统, enable_security_policy打开且本参数打开后，统一审计日志会通过http(https)传递至Elastic Search系统（默认使用https安全协议）。此参数打开后需要保证elastic_search_ip_addr对应的es服务可正常连通，否则进程启动失败。 该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 取值范围：布尔型。 on：使能统一审计日志发送至Elastic Search。 off：关闭统一审计日志发送至Elastic Search。 默认值：off

wdr_snapshot_full_backup_interval 参数说明：WDR snapshot做全量快照的间隔。该参数控制的不是时间间隔，而是间隔个数。例如，当取值为12时，每一组先生成一个全量快照，再生成11个增量快照；当取值为1时，每个快照都是全量快照。 当且仅当enable_wdr_snapshot参数取值为on时，该参数设置有效。 若在已经生成若干个快照的情况下，更改该参数取值，下一个快照会是全量快照。例如，WDR snapshot当前已经生成了5个增量快照，此时更改参数取值为10，那么下一个快照会是全量快照，然后开启新的周期。 在删除快照的时候，会遵循一组快照一起删除的规则。删除快照的数量受最早的一组快照产生时该参数的取值影响，与该参数的当前取值无关。 参数类型：整型 参数单位：个 取值范围：1～24 默认值：12 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：根据需求场景进行配置。该参数取值越小，全量快照越多，同样空间占用下能保留的总快照数量越少。

wdr_snapshot_space_threshold 参数说明：快照空间占用维度的控制阈值。当快照占用空间达到该参数取值的50%时，会启用数据库的控制逻辑，使快照占用空间趋于平稳。 当且仅当enable_wdr_snapshot参数取值为on时，该参数设置有效。 若将该参数取值改得比当前快照占用空间要小，并不会使快照占用空间回缩，而是开启控制逻辑，控制快照增长，使快照占用空间趋于平稳。 参数类型：整型 参数单位：kB 取值范围：0 ～ 107374182400 默认值：0，表示不开启按空间阈值控制快照占用空间的功能。 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：根据需求场景进行配置。

asp_sample_num 参数说明：LOCAL_ACTIVE_SESSION视图最大的样本个数，仅sysadmin用户可以访问。 参数类型：整型 参数单位：无 取值范围：10～100000 默认值：100000（196核CPU/1536G内存，128核CPU/1024G内存，104核CPU/1024G内存，96核CPU/1024G内存，96核CPU/768G内存，80核CPU/640G内存，64核CPU/512G内存，60核CPU/480G内存，32核CPU/256G内存，16核CPU/128G内存，8核CPU/64G内存，4核CPU/32G内存）；36000（4核CPU/16G内存） 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：设置为默认值。若要更改，请在理解参数含义后谨慎操作，避免因误操作产生意料之外的风险。

wdr_snapshot_interval 参数说明：后台线程Snapshot自动对数据库监控数据执行各项快照操作的时间间隔。 当且仅当enable_wdr_snapshot参数取值为on时，该参数设置有效。 参数类型：整型 参数单位：分钟 取值范围：10～60 默认值：60 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。例如，不带单位取值60，表示wdr_snapshot_interval为60min；带单位取值1h，表示wdr_snapshot_interval为1h。取值如果要带单位，必须为min、h、d。 设置建议：设置为默认值。在固定保留天数下，该参数取值越小，磁盘占用量越大。

wdr_snapshot_retention_days 参数说明：系统中数据库监控快照数据的保留天数。当数据库运行过程期间所生成的快照数量超过保留天数内允许生成的快照数量的最大值(默认为24*8=192)时，系统将每隔wdr_snapshot_interval时间间隔，清理一次snapshot_id最小的快照数据。 当且仅当enable_wdr_snapshot参数取值为on时，该参数设置有效。 参数类型：整型 参数单位：天 取值范围：1～30 默认值：8 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：设置为默认值。该参数取值越大，磁盘占用越高。

enable_wdr_snapshot_standby 参数说明：是否开启备机支持数据库监控快照功能。 参数类型：布尔型 参数单位：无 取值范围： on：打开备机支持数据库监控快照功能。 off：关闭备机支持数据库监控快照功能。 默认值：off 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：设置为默认值。若要更改，请在理解参数含义后谨慎操作，避免因误操作产生意料之外的风险。

enable_wdr_snapshot 参数说明：是否开启数据库监控快照功能。 参数类型：布尔型 参数单位：无 取值范围： on：打开数据库监控快照功能。 off：关闭数据库监控快照功能。 默认值：on 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：设置为默认值。 不建议打开的场景： 在多表和多库的场景下，wdr snapshot会在每个库串行记录快照，记录快照时间会很长，不建议打开。 在多表的场景下，由于内部的一些表的性能问题，pg_stat_all_tables在多表的场景下，查询很慢，这时做wdr snapshot就会很慢，所以不建议打开。 如果在大量DDL期间做WDR snapshot会可能造成WDR snapshot失败，不建议打开。

asp_log_directory 参数说明：asp_flush_mode设置为all或者file时，asp_log_directory决定存放服务器asp日志文件的目录。它可以是绝对路径，或者是相对路径（相对于数据目录的路径），仅sysadmin用户可以访问。 该参数属于POSTMASTER类型参数，请参见表1中对应设置方法进行设置。 当配置文件中asp_log_directory的值为非法路径时，会导致数据库实例无法重新启动。 合法路径：用户对此路径有读写权限。 非法路径：用户对此路径无读写权限。 取值范围：字符串 默认值：安装时指定。

query_log_file（废弃） 参数说明：GUC参数enable_slow_query_log设置为ON，表示需要将慢查询记录写进日志文件中，query_log_file决定服务器慢查询日志文件的名称，仅sysadmin用户可以访问。通常日志文件名是按照strftime模式生成，因此可以用系统时间定义日志文件名，用%转义字符实现，在该版本中已废弃。 该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。 建议使用%转义字符定义日志文件名称，否则难以对日志文件进行有效地管理。 取值范围：字符串 默认值：slow_query_log-%Y-%m-%d_%H%M%S.log

query_log_directory（废弃） 参数说明：enable_slow_query_log设置为on时，query_log_directory决定存放服务器慢查询日志文件的目录，仅sysadmin用户可以访问。它可以是绝对路径，或者是相对路径（相对于数据目录的路径），在该版本中已废弃。 该参数属于POSTMASTER类型参数，请参见表1中对应设置方法进行设置。 当配置文件中query_log_directory的值为非法路径时，会导致数据库实例无法重新启动。 合法路径：用户对此路径有读写权限。 非法路径：用户对此路径无读写权限。 取值范围：字符串 默认值：安装时指定。

track_stmt_standby_chain_size 参数说明：组合参数，控制备机快/慢SQL记录的最大占用内存与磁盘空间。仅SysAdmin用户可以访问。 该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。 取值范围：字符型 该参数分为四部分，形式为'Full SQL memory size, Full SQL disk size, Slow SQL memory size, Slow SQL disk size' 。 Full SQL与Slow SQL分开存放于不同位置，因此额外使用了四个值进行控制。 Full SQL memory size 为保留的快SQL的最大内存占用空间，取值范围为 [16, 1024]，单位为MB。 Full SQL disk size 为保留的快SQL的最大磁盘占用空间，取值范围为 [512, 1048576]，单位为MB。 Slow SQL memory size 为保留的慢SQL的最大内存占用空间，取值范围为 [16, 1024]，单位为MB。 Slow SQL disk size 为保留的慢SQL的最大磁盘占用空间，取值范围为 [512, 1048576]，单位为MB。 其中内存值不可大于磁盘值。 默认值：32, 1024, 16, 512

track_stmt_flush_mode 参数说明：控制Full SQL的存储模式。 参数类型：字符型 参数单位：无 取值范围： 该参数分为两部分，形式为'full sql flush mode, slow sql flush mode'： 第一部分为全量SQL跟踪模式，取值可为MEMORY、FILE。参数设置为MEMORY，会记录全量SQL语句到内存中；参数设置为FILE，会记录全量SQL语句到磁盘文件中。 第二部分为慢SQL跟踪模式，当前版本取值仅为FILE。参数设置为FILE，会记录慢SQL语句到磁盘文件中。 默认值：“FILE,FILE” 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：如果设置参数为“MEMORY,FILE”会打开内核支持全量SQL功能，会占用一定共享内存，内存大小由track_stmt_shm_size参数控制。

instr_unique_sql_combination_options 参数说明：Unique SQL 同类语句归并功能配置项，该参数的值由若干个配置项用逗号隔开构成。 开启该特性会将同类语句的Unique SQL ID归一，并将生成的Unique SQL String做归一化处理。 参数类型：字符串 参数单位：无 取值范围：参照表1 归并功能配置时，按照表1设置字符串，多个配置项之间用逗号隔开，例如：set instr_unique_sql_combination_options='in_clause'; 参数设置为空时，即为不开启该功能，例如：set instr_unique_sql_combination_options=''; 表1 归并功能配置项 归并功能配置项 归并功能行为控制 in_clause 控制select in()语句的in中仅含有固定参数与预编译绑定参数的情况进行归并。 例1：select * from table where column in (1,2,3)； 归并后Unique SQL String：select * from table where column in (1…n); 例2：select * from table where column in ($1,$2,$3)； 归并后Unique SQL String：select * from table where column in ($1…$n); 例3：select * from example_table where column in (1,2,$1,3,$2); 归并后Unique SQL String：select * from example_table where column in (1...n,$1...$n); 例4：select * from example_table where (column1, column2) in ((1, 'a'), (2, 'b'), (3, 'c')); 归并后Unique SQL String：select * from example_table where (column1, column2) in ((1...n)); 默认值：'in_clause' 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：升级时默认关闭，新实例下发时默认开启。 使用该特性将使涉及归并的查询语句的Unique SQL ID发生改变，会对已创建SQLpatch的SQL语句产生影响。 对于bigint，real，float4，blob，numeric，decimal，number，dec，integer类型的值，在in()中含有单个参数与多个参数的两种情况，会生成两种不同的unique_sql_id。

enable_auto_clean_unique_sql 参数说明：当系统中产生的unique sql条目数量大于等于instr_unique_sql_count参数取值时，是否启用unique sql自动淘汰功能。 参数类型：布尔型 参数单位：无 取值范围： on：打开unique sql自动淘汰功能。 off：关闭unique sql自动淘汰功能。 默认值：off 设置方式：该参数属于POSTMASTER类型参数，请参见表1中对应设置方法进行设置。 设置建议：根据业务需要酌情进行调整。开启该功能可以节省一定磁盘空间，但可能丢失wdr报告。 由于快照有部分信息是来源于unique sql，所以开启自动淘汰的情况下，在生成wdr报告时，如果选择的起始快照和终止快照跨过了淘汰发生的时间，会导致无法生成wdr报告。

enable_stmt_track 参数说明：控制是否启用Full /Slow SQL特性。 在x86架构集中式部署下，硬件配置规格为32核CPU/256GB内存，使用Benchmark SQL 5.0工具测试性能，开关此参数性能影响约1.2%。 该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。 取值范围：布尔型 on：表示开启Full /Slow SQL捕获。 off：表示关闭Full /Slow SQL捕获。 默认值：on

track_stmt_session_slot 参数说明：设置一个session缓存的最大的全量SQL和慢SQL的数量，超过这个数量，新的语句执行将不会被跟踪，直到落盘线程将缓存语句落盘，留出空闲的空间。 参数类型：整型 参数单位：无 取值范围：0 ~ 2147483647。 默认值：1000 设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。 设置建议：设置为默认值，即每个session能够保留的全量SQL的最大槽位。该参数如果太大会占用较大内存，较小的话可能出现全量SQL丢失

track_stmt_retention_time 参数说明：组合参数，控制全量/慢SQL记录的保留时间。以60秒为周期读取该参数，并执行清理超过保留时间的记录，仅sysadmin用户可以访问。 该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。 取值范围：字符型，该参数分为两部分，形式为'full sql retention time, slow sql retention time' full sql retention time为全量SQL保留时间，取值范围为0 ~ 86400，单位为秒。 slow sql retention time为慢SQL的保留时间，取值范围为0 ~ 604800，单位为秒。 默认值：3600,604800

instr_unique_sql_track_type 参数说明：unique sql记录SQL方式。 该参数属于USERSET类型参数，请参见表1中对应设置方法进行设置。 取值范围：枚举类型 top：只记录顶层SQL。 all：记录所有SQL。 默认值：all 该参数默认为all。与设置为top时相比，为all时会额外记录存储过程内语句的统计信息，对存储过程的执行会产生一定的性能损耗，对于存储过程内简单表达式等执行较快的语句产生的性能影响会更加严重。

enable_instr_cpu_timer 参数说明：是否捕获sql执行的cpu时间消耗。 在x86架构集中式部署下，硬件配置规格为32核CPU/256GB内存，使用Benchmark SQL 5.0工具测试性能，开关此参数性能影响约3.5%。 该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。 取值范围：布尔型 on：表示捕获sql执行的cpu时间消耗。 off：表示不捕获sql执行的cpu时间消耗。 默认值：on

track_stmt_parameter 参数说明：开启track_stmt_parameter后，在statement_history中记录的执行语句不再进行归一化操作，可以显示完整SQL语句信息，辅助DBA进行问题定位。其中对于简单查询，显示完整语句信息；对于PBE语句，显示完整语句信息的同时，追加每个变量数值信息，格式为“query string；parameters:$1=value1,$2=value2,...”。该参数提供目的是为用户呈现完整SQL信息，不受track_activity_query_size参数控制。 该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。 取值范围：布尔型 on：表示开启显示完整SQL语句信息的功能。 off：表示关闭显示完整SQL语句信息的功能。 默认值：off

enable_instr_track_wait 参数说明：是否开启等待事件信息实时收集功能。 在x86架构集中式部署下，硬件配置规格为32核CPU/256GB内存，使用Benchmark SQL 5.0工具测试性能，开关此参数性能影响约1.4%。 该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 取值范围：布尔型 on：表示打开等待事件信息收集功能。 off：表示关闭等待事件信息收集功能。 默认值：on

datastorage_threshold_value_check 参数说明：设置数据库只读模式的磁盘占用阈值，当数据目录所在磁盘占用超过这个阈值，自动将数据库设置为只读模式。数据库只读后无法限制日志回放，应当关注集群磁盘容量，及时处理数据库只读相关告警，防止出现磁盘空间写满、出现无法快速恢复的场景。 参数类型：整型 参数单位：百分比 取值范围：1 ~ 99。 默认值：85 设置方式：修改后可以reload生效，参数修改请参考表2进行设置。 设置建议：建议设置为默认值，不做调整。根据磁盘空间可作适当调整，调整该参数时，建议同步调整dn的max_size_for_xlog_retention参数，避免因备份操作触发实例只读阈值。

ddb_log_level 参数说明：设置ddb日志级别。 关闭日志：“NONE”，NONE表示关闭日志打印，不能与以下日志级别混合使用。 开启日志：“RUN_ERR|RUN_WAR|RUN_INF|DEBUG_ERR|DEBUG_WAR|DEBUG_INF|TRACE|PROFILE|OPER”日志级别可以从上述字符串中选取字符串并使用竖线组合使用，不能配置空串。 取值范围：字符串，RUN_ERR|RUN_WAR|RUN_INF|DEBUG_ERR|DEBUG_WAR|DEBUG_INF|TRACE|PROFILE|OPER。修改后可以reload生效，参数修改请参考表2进行设置。 默认值：RUN_ERR|RUN_WAR|DEBUG_ERR|OPER|RUN_INF|PROFILE

enable_finishredo_retrieve 参数说明：cm_server强切后是否对redo切除的xlog进行数据找回的功能开关。在enable_finishredo_retrieve被置为on时，发生强切后进行数据自动找回。 参数类型：布尔型 参数单位：无 取值范围： off：表示关闭。 on：表示开启。 默认值：off 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：如果用户可以接受业务（系统）发生强切导致部分数据丢失，恢复业务的优先级最高的情况就可以设置为开启。

cm_krb_server_keyfile 参数说明：kerberos服务端key文件所在位置，需要配置为绝对路径。该文件通常为${GAUSSHOME}/kerberos路径下，以keytab格式结尾，文件名与数据库运行所在用户名相同。与上述cm_auth_method参数是配对的，当cm_auth_method参数修改为gss时，该参数也必须配置为正确路径，否则将影响数据库状态 取值范围：字符串类型，修改后可以reload生效，参数修改请参考表2进行设置。 默认值：${GAUSSHOME}/kerberos/{UserName}.keytab，默认值无法生效，仅作为提示

dilatation_shard_count_for_disk_capacity_alarm 参数说明：扩容场景下，设置新增的扩容分片数，用于上报磁盘容量告警时的阈值计算。 该分片数请与实际扩容分片数设置为一致。 取值范围：整型，0~232 - 1，单位为个。该参数设置为0，表示关闭磁盘扩容告警上报；该参数设置为大于0，表示开启磁盘扩容告警上报，且告警上报的阈值根据此参数设置的分片数量进行计算。修改后可以reload生效，参数修改请参见表2进行设置。 默认值：1

enable_access_server_directory 参数说明：是否开启非初始用户创建、修改和删除DIRECTORY的权限。 该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。 取值范围：布尔型 on表示开启非初始用户创建、修改和删除DIRECTORY的权限。 off表示不开启非初始用户创建、修改和删除DIRECTORY的权限。 默认值：off 出于安全考虑，默认情况下，只有初始用户才能够创建、修改和删除DIRECTORY对象。 如果开启了enable_access_server_directory，具有SYSADMIN权限的用户和继承了内置角色gs_role_directory_create权限的用户可以创建directory对象；具有SYSADMIN权限的用户、directory对象的属主、被授予了该directory的DROP权限的用户或者继承了内置角色gs_role_directory_drop权限的用户可以删除directory对象；具有SYSADMIN权限的用户和directory对象的属主可以修改directory对象的所有者，且要求该用户是新属主的成员。

audit_system_function_exec 参数说明：这个参数决定在执行白名单内的系统函数时是否记录审计日志。 该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。 取值范围：整型，0、1。 0表示关闭对系统函数执行的审计功能。 1表示开启对系统函数执行的审计功能。 默认值：0 支持记录审计的系统函数白名单如下表所示： set_working_grand_version_num_manually set_config pg_cancel_backend pg_cancel_session pg_reload_conf pg_rotate_logfile pg_terminate_session pg_terminate_backend pg_create_restore_point pg_start_backup pg_stop_backup pg_switch_xlog pg_cbm_rotate_file pg_cbm_get_merged_file pg_cbm_recycle_file pg_enable_delay_ddl_recycle pg_disable_delay_ddl_recycle gs_roach_stop_backup gs_roach_enable_delay_ddl_recycle gs_roach_disable_delay_ddl_recycle gs_roach_switch_xlog pg_last_xlog_receive_location pg_xlog_replay_pause pg_xlog_replay_resume gs_pitr_clean_history_global_barriers gs_pitr_archive_slot_force_advance pg_create_physical_replication_slot_extern gs_set_obs_delete_location gs_hadr_do_switchover gs_set_obs_delete_location_with_slotname gs_streaming_dr_in_switchover gs_upload_obs_file gs_download_obs_file gs_set_obs_file_context gs_get_hadr_key_cn pg_advisory_lock pg_advisory_lock_shared pg_advisory_unlock pg_advisory_unlock_shared pg_advisory_unlock_all pg_advisory_xact_lock pg_advisory_xact_lock_shared pg_try_advisory_lock pg_try_advisory_lock_shared pg_try_advisory_xact_lock pg_try_advisory_xact_lock_shared pg_create_logical_replication_slot pg_drop_replication_slot pg_logical_slot_peek_changes pg_logical_slot_get_changes pg_logical_slot_get_binary_changes pg_replication_slot_advance pg_replication_origin_create pg_replication_origin_drop pg_replication_origin_session_setup pg_replication_origin_session_reset pg_replication_origin_session_progress pg_replication_origin_xact_setup pg_replication_origin_xact_reset pg_replication_origin_advance local_space_shrink gs_space_shrink pg_free_remain_segment gs_fault_inject gs_repair_file local_clear_bad_block_info gs_repair_page - - - - -

audit_xid_info 参数说明：该参数决定是否在审计日志字段detail_info中记录SQL语句的事务ID。 参数类型：整型 参数单位：无 取值范围：0、1。 0表示关闭审计日志记录事务ID功能。 1表示开启审计日志记录事务ID功能。 默认值：0 设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。 设置建议：设置为默认值。 如果开启此开关，审计日志中detail_info信息则以xid开始，例如： detail_info: xid=14619 , create table t1(id int); 对于不存在事务ID的审计行为，则记录xid=NA。