华为云用户手册

walwriter_cpu_bind 参数说明：把walwriter线程绑定到指定CPU核上运行。 参数类型：整型 参数单位：无 取值范围：-1~核数减1。CPU核从0号开始排序。 -1：表示不进行绑核操作。 N：表示把walwriter线程绑定到第N号CPU核上。 默认值：-1 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

wal_sender_bind_cpu_attr 参数说明：用于控制日志发送的绑核操作，仅sysadmin用户可以访问。 参数类型：字符串 参数单位：无 取值范围：长度大于0，该参数不区分大小写。 'nobind'：线程不做绑核。 'cpuorderbind: 8-12': 从8号核开始一个线程绑定一个CPU，区间内核不足就不参与绑定。建议区间大小设置为大于等于参数max_wal_senders。 默认值：'nobind' 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

wal_file_preinit_bounds 参数说明：业务运行时，WAL writer辅助线程每秒可预扩的WAL日志段文件的数量限制（WAL日志段文件的大小为16MB）。当该参数值为0时，表示不进行限制。 参数类型：整型 参数单位：无 取值范围：0~1024 默认值：0 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐设置为默认值，不做调整。当把该参数设置为有效值时，需基于磁盘I/O能力进行设置，可参考参数max_io_capacity的数值进行设置。 若max_io_capacity为500MB，可设置为25； 若max_io_capacity为1GB，可设置为50。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

fsync 参数说明：设置 GaussDB 服务器是否使用fsync()系统函数确保数据的更新及时写入物理磁盘中（fsync()系统函数实现的种类，请参见参数wal_sync_method）。 使用fsync()系统函数可以保证在操作系统或者硬件崩溃的情况下将数据恢复到一个已知的状态。 如果将此参数关闭，可能会在系统崩溃时无法恢复原来的数据，导致数据库不可用。 参数类型：布尔型 参数单位：无 取值范围： on：表示使用fsync()系统函数。 off：表示不使用fsync()系统函数。 默认值：on 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

wal_sync_method 参数说明：参数fsync开启的前提情况下，设置向磁盘强制更新WAL数据的方法。 如果参数fsync关闭，这个参数的设置就没有意义，因为所有数据更新都不会强制写入磁盘。 参数类型：枚举类型 参数单位：无 取值范围： open_datasync：表示用带O_DSYNC选项的open()打开“WAL”文件。 fdatasync：表示每次提交的时候都调用fdatasync()（支持suse10和suse11）。 fsync_writethrough：表示每次提交的时候调用fsync()强制把缓冲区任何数据写入磁盘。 fsync：表示每次提交的时候调用fsync()（支持suse10和suse11）。 open_sync：表示用带O_SYNC选项的open()写“WAL”文件（支持suse10和suse11）。 不是所有的平台都支持以上参数。 由于历史原因，Windows平台支持将wal_sync_method设置为fsync_writethrough。在windows平台上fsync_writethrough和fsync等效。 在集中式环境，如果配置了enable_standby_walsync_optimization参数，打开WAL日志同步性能优化，在备机上WAL日志采用ADIO方式写盘，写盘固定为PG_O_DIRECT | OPEN_DATASYNC_FLAG方式，不受wal_sync_method参数影响。enable_standby_walsync_optimization参数只影响集中式的备机写盘方式，不影响主机。分布式不支持enable_standby_walsync_optimization参数。 默认值：fdatasync 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

GS_ LOG ICALSTANDBY_SKIP_TRANSACTION GS_LOGICALSTANDBY_SKIP_TRANSACTION视图展示定义的SKIP规则，当skiptype为2时（详见GS_SQLAPPLY_SKIP系统表字段），从系统表GS_SQLAPPLY_SKIP中获取如下字段创建或更新系统视图。 表1 GS_LOGICALSTANDBY_SKIP_TRANSACTION字段 名称 类型 属性 createtime timestamp SKIP定义时间。 dumpcontext char 转储类型。 commitcsn text 事务提交序号。 xid xid 事务标识。 父主题： 其他系统视图

SUMMARY_STAT_USER_INDEXES 显示数据库各节点所有Schema中用户自定义普通表的索引状态信息的汇总求和结果，如表1所示。 表1 SUMMARY_STAT_USER_INDEXES字段 名称 类型 描述 schemaname name 索引所在的Schema名。 relname name 索引的表名。 indexrelname name 索引名。 idx_scan numeric 该索引上执行的索引扫描次数。 idx_tup_read numeric 该索引上扫描返回的索引项数。 idx_tup_fetch numeric 使用该索引的简单索引扫描在原表中抓取的活跃行数。 父主题： Object

copy_special_character_version 参数说明：控制使用COPY导入导出数据时对非法编码的字符处理的相关表现。 参数类型：字符串 参数单位：无 取值范围：""、"no_error"、"per_byte"。 表2 兼容性配置项 兼容性配置项 兼容性行为控制 no_error 使用COPY导入数据文件时，当文件编码与服务端编码相同时，对数据文件中不满足编码信息的数据进行容错处理，不报错，并直接按照原编码插入表中。 per_byte 使用COPY导出文本格式的数据文件时，对文件编码为GBK或ZHS16GBK文件的处理方式。 设置per_byte后，在导出数据时一次导出一个字节数据，否则一次导出两个字节数据（GBK编码下，一个字符占两个字节）。 空字符串 参数默认配置，不影响任何功能使用，做前向兼容处理。即COPY存在非法编码时报错。 默认值："" 设置方式：该参数属于USERSET类型参数，请参见表1中对应设置方法进行设置。使用gsql连接数据库，使用set方式设置时不区分大小写，使用gs_guc设置时仅能设置小写。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。 为保证导入表中数据的合法性，COPY中需要对数据编码的合法性进行校验。当开启此参数后，会屏蔽非法校验操作并导致字段内出现非法字符，请酌情考虑开启此参数。 当前屏蔽数据编码校验仅在服务端编码与数据编码保持一致时生效，即copy_special_character_version='no_error'时，数据库服务端编码须与数据文件编码保持一致，否则会报错；未指定数据编码时，数据编码默认为客户端编码。 二进制模式下，copy_special_character_version='no_error'时，仅对TEXT、CHAR、VARCHAR、NVARCHAR2、CLOB类型的字段生效。 此参数仅在UTF-8、GB18030、GB18030_2022、ZHS16GBK、LATIN1字符集数据库下使用生效。 客户端编码与服务端编码都为GBK或ZHS16GBK时，当数据库内存在非法编码的数据时，如果不设置copy_special_character_version为per_byte，导出的数据文件中可能会存在预期外的数据。 设置copy_special_character_version值为'no_error'的优先级高于COPY内COMPATIBLE_ILLEGAL_CHARS参数。

enable_log_copy_illegal_chars 参数说明：使用gs_loader导入数据及COPY导入导出数据时，遇到非法编码的字符时，是否向数据库运行日志中写入记录。多租场景下，该参数可在PDB级别设置。 参数类型：布尔型 参数单位：无 取值范围：on、off。 表3 兼容性配置项 兼容性配置项 兼容性行为控制 on 每出现一行包括非法编码字符的数据，都会向数据库运行日志中写入一条记录。 off 不向数据库运行日志中写入非法编码字符相关记录。 默认值：on。在PDB场景内，若未设置该参数，则继承来自全局的设置。 设置方式：该参数属于USERSET类型参数，请参见表1中对应设置方法进行设置。 设置建议：无特殊情况时建议配置为默认值，仅对数据库性能及磁盘带宽有要求时设置为off。 设置不当的风险与影响：设置为off时将不会在运行日志中写入非法编码字符相关记录，影响可定位能力。

raise_errors_if_no_files 参数说明：设置导入时是否区分“导入文件记录数为空”和“导入文件不存在”。该参数开启时，“导入文件不存在”的时候，GaussDB将抛出“文件不存在”的错误。该参数可在PDB级别设置。 参数类型：布尔型 参数单位：无 取值范围： on：表示导入时区分“导入文件记录数为空”和“导入文件不存在”。 off：表示导入时不区分“导入文件记录数为空”和“导入文件不存在”。 默认值：off。在PDB场景内，若未设置该参数，则继承来自全局的设置。 设置方式：该参数属于SUSET类型参数，请参见表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。 raise_errors_if_no_files参数只在GDS工具使用场景有意义，在当前形态不生效。

support_binary_copy_version 参数说明：使用COPY TO的BINARY模式导出数据时，是否包含当前数据库服务端的编码信息。 参数类型：字符串 参数单位：无 取值范围：""、"header_encoding"。 表1 兼容性配置项 兼容性配置项 兼容性行为控制 header_encoding 使用COPY TO的BINARY模式导出数据时，二进制文件头中包含当前数据库服务端的编码信息。 空字符串 做前向兼容处理时配置，以原二进制格式进行导出。 默认值："header_encoding" 设置方式：该参数属于USERSET类型参数，请参见表1中对应设置方法进行设置。 设置建议：无特殊情况时建议配置为默认取值，仅做前向兼容时需另行配置为空。 设置不当的风险与影响：设置为空字符串时，导出结果中不包含服务端编码信息，在需要编码信息的场景下，需要用户自行查询并记录。

safe_data_path 参数说明：设置初始用户以外的路径前缀限制，目前包括copy和高级包路径限制。 参数类型：字符串 参数单位：无 取值范围：合法目录路径，需要小于4096个字符。 默认值："" 设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。 设置建议：尽量控制safe_data_path路径覆盖有限范围，不要设置过大的路径范围。 设置不当的风险与影响：当enable_copy_server_files打开，并且safe_data_path路径范围设置过大时，可能导致恶意用户访问到服务器上的敏感文件。 如果safe_data_path目录下存在软链接文件，则会按软链接实际指向的文件路径进行处理，实际路径如果不在safe_data_path下会报错处理。 如果safe_data_path目录下存在硬链接文件，则可以正常使用。为安全起见，请谨慎使用硬链接文件，切勿在safe_data_path目录下创建指向目录以外的硬链接文件，并确保safe_data_path目录权限最小化。

enable_copy_server_files 参数说明：是否开启copy服务器端文件的权限。 参数类型：布尔型 参数单位：无 取值范围： on：表示开启copy服务端文件的权限，允许具有SYSADMIN权限的用户或继承了内置角色gs_role_copy_files权限的用户执行COPY FROM FILENAME或COPY TO FILENAME命令。该参数设置为on时，多租场景下，当前依旧不支持非初始用户在PDB内部执行COPY FROM FILENAME或COPY TO FILENAME命令。 off：表示不开启copy服务端文件的权限，只允许初始用户执行COPY FROM FILENAME或COPY TO FILENAME命令。 默认值：off 设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。 设置建议：仅在需要copy服务端文件时打开，打开后建议同步设置safe_data_path。 设置不当的风险与影响：打开该参数后，如果safe_data_path设置路径范围过大，可能导致恶意用户访问到服务器上的敏感文件。

a_format_load_with_constraints_violation 参数说明：gs_loader导入数据支持约束冲突时，是否开启不回滚功能。该参数可在PDB级别设置。 参数类型：字符串 参数单位：无 取值范围： "s1"：表示gs_loader支持约束冲突时，开启不回滚功能。 ""：表示gs_loader支持约束冲突时，不开启不回滚功能。 默认值：""。在PDB场景内，若未设置该参数，则继承来自全局的设置。 设置方式：该参数属于USERSET类型参数，请参见表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

GS_LOGICALSTANDBY_SKIP GS_LOGICALSTANDBY_SKIP视图展示定义的SKIP规则，当skiptype为1或者3时（详见GS_SQLAPPLY_SKIP系统表字段），从系统表GS_SQLAPPLY_SKIP中获取如下字段创建或更新系统视图。 表1 GS_LOGICALSTANDBY_SKIP字段 名称 类型 说明 createtime timestamp SKIP定义时间。 error bool 是否错误发生才触发。 dump char 转储类型 stmt text SKIP语句或KEYWORD。 dbname name 数据库名称。 schemaname name 模式名称。 objectname name 对象名称。 父主题： 其他系统视图

enable_asp 参数说明：设置是否开启活跃会话信息active session profile。 参数类型：布尔型 参数单位：无 取值范围： on：打开active session profile功能。 off：关闭active session profile功能。 默认值：on 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

asp_flush_mode 参数说明：ASP刷新到磁盘上的方式分为写文件和写系统表，当取值为“file”时，默认写文件，为“table”时写系统表，为“all”时，即写文件也写系统表，仅sysadmin用户可以访问。 参数类型：字符串 参数单位：无 取值范围：当前有效值有“table”、“file”、“all”。 默认值："table" 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

asp_sample_interval 参数说明：每次采样的间隔。 参数类型：整型 参数单位：秒（s） 取值范围：1 ~ 10 默认值：1 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。例如，不带单位取值10，表示asp_sample_interval为10s；带单位取值10s，表示asp_sample_interval为10s。取值如果要带单位，必须为s、min、h、d。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

enable_asp_standby 参数说明：设置是否开启ASP支持备机功能。开启该功能后，ASP报告进行采样时，会同步获取备机的采集数据。 参数类型：布尔型 参数单位：无 取值范围： on：开启ASP支持备机功能，ASP获取所有备机上的采集数据。 off：关闭ASP支持备机功能。 默认值：on 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

asp_flush_rate 参数说明：当内存中样本个数达到asp_sample_num时，会按一定比例把内存中样本刷新到磁盘上，asp_flush_rate为刷新比例。该参数为10时表示按10:1进行刷新。 参数类型：整型 参数单位：无 取值范围：1 ~ 10 默认值：10 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：设置值过小会导致刷盘数据量变大。

asp_log_filename 参数说明：当ASP写文件时，生成文件名的格式，仅sysadmin用户可以访问。 参数类型：字符串 参数单位：无 取值范围：合法的文件名格式字符串。 默认值："asp-%Y-%m-%d_%H%M%S.log" 设置方式：该参数属于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中对应设置方法进行设置。 设置建议：推荐使用默认值。若要更改，请在理解参数含义后谨慎操作，避免因误操作产生意料之外的风险。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

asp_flush_interval 参数说明：设置ASP定时刷盘的时间间隔。 参数类型：整型 参数单位：秒（s） 取值范围：300 ~ 3600 默认值：300 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。例如，不带单位取值60，表示asp_flush_interval为60s；带单位取值1min，表示asp_flush_interval为1min。取值如果要带单位，必须为s、min、h、d。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

enable_show_standby_name 参数说明：设置是否开启显示区分同一分片主备机名字的功能，该名字区分主备节点。开启该功能后在同一分片的不同节点上查询dbe_perf.node_name，返回不同的名字。该参数可在PDB级别设置。 参数类型：布尔型 参数单位：无 取值范围： on：打开视图区分主备机名字功能。 off：关闭视图区分主备机名字功能 默认值：off。在PDB场景内，若未设置该参数，则继承来自全局的设置。 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。

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

wdr_snapshot_query_timeout 参数说明：系统执行数据库监控快照操作时，设置快照操作相关的sql语句的执行超时时间。如果语句超过设置的时间没有执行完并返回结果，则本次快照操作失败，但会将已经生成的部分快照保留下来。 参数类型：整型 参数单位：秒（s） 取值范围：0 ~ 2147483647 默认值：100 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置，0表示不作超时限制。例如，不带单位取值60，表示wdr_snapshot_query_timeout为60s；带单位取值1min，表示wdr_snapshot_query_timeout为1min。取值如果要带单位，必须为s、min、h、d。 设置建议：根据需求场景进行配置。如果不关心快照中的数据，希望快速生成快照，可以适当地将该参数取值调小；如果需要快照中的数据尽量完备，可以相应地将该参数取值调大。 设置不当的风险与影响：在生成快照超时的前提下，该参数取值越大，超时时间越长，导致生成快照的时间变长，但快照内的数据更完备。

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

wdr_snapshot_space_threshold 参数说明：快照空间占用维度的控制阈值。当快照占用空间达到该参数取值的50%时，会启用数据库的控制逻辑，使快照占用空间趋于平稳。 当且仅当enable_wdr_snapshot参数取值为on时，该参数设置有效。 若将该参数取值改得比当前快照占用空间要小，并不会使快照占用空间回缩，而是开启控制逻辑，控制快照增长，使快照占用空间趋于平稳。 参数类型：整型 参数单位：kB 取值范围：0 ~ 107374182400 默认值：0，表示不开启按空间阈值控制快照占用空间的功能。 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。例如，不带单位取值1024，表示wdr_snapshot_space_threshold为1024kB；带单位取值1MB，表示wdr_snapshot_space_threshold为1MB。取值如果要带单位，必须为kB、MB、GB。 设置建议：根据需求场景进行配置。 设置不当的风险与影响：设置不当可能导致存量快照数量仅剩最新一组快照。

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

enable_wdr_snapshot 参数说明：设置是否开启数据库监控快照功能。 参数类型：布尔型 参数单位：无 取值范围： on：打开数据库监控快照功能。 off：关闭数据库监控快照功能。 默认值：on 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改，避免出现意料之外的结果。 不建议打开的场景： 在多表和多库的场景下，wdr snapshot会在每个库串行记录快照，记录快照时间会很长，不建议打开。 在多表的场景下，由于内部的一些表的性能问题，pg_stat_all_tables在多表的场景下，查询很慢，这时做wdr snapshot就会很慢，所以不建议打开。 如果在大量DDL期间做WDR snapshot会可能造成WDR snapshot失败，不建议打开。