华为云用户手册

云数据库 GaussDB-安全和认证（postgresql.conf）:require_ssl

require_ssl 参数说明：设置服务器端是否强制要求SSL连接，该参数只有当参数ssl为on时才有效。请在使用这个选项之前阅读通过gsql连接实例章节。该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。取值范围：布尔型 on表示服务器端强制要求SSL连接。 off表示服务器端对是否通过SSL连接不作强制要求。 GaussDB 目前支持SSL的场景为客户端连接数据库主节点场景，该参数目前建议只在数据库主节点中开启。默认值：off

云数据库 GaussDB
云数据库 GaussDB-安全和认证（postgresql.conf）:failed_login_attempts

failed_login_attempts 参数说明：在任意时候，如果输入密码错误的次数达到failed_login_attempts则当前账户被锁定，password_lock_time秒后被自动解锁，仅sysadmin用户可以访问。例如，登录时输入密码失败，ALTER USER时修改密码失败等。该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 failed_login_attempts和password_lock_time必须都为正数时锁定和解锁功能才能生效。取值范围：整型，最小值为0，最大值为1000。 0表示自动锁定功能不生效。正整数表示当错误密码次数达到failed_login_attempts设定的值时，当前账户将被锁定。默认值：10

云数据库 GaussDB
云数据库 GaussDB-安全和认证（postgresql.conf）:password_reuse_time

password_reuse_time 参数说明：在使用ALTER USER或者ALTER ROLE修改用户密码时，该参数指定是否对新密码进行可重用天数检查。该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。修改密码时会检查配置参数password_reuse_time和password_reuse_max。当password_reuse_time和password_reuse_max都为正数时，只要满足其中任一个，即可认为密码可以重用。当password_reuse_time为0时，表示不限制密码重用天数，仅限制密码重用次数。当password_reuse_max为0时，表示不限制密码重用次数，仅限制密码重用天数。当password_reuse_time和password_reuse_max都为0时，表示不对密码重用进行限制。取值范围：浮点型（天），最小值为0，最大值为3650。 0表示不检查密码可重用的天数。正数表示新密码不能为该值指定的天数内使用过的密码。默认值：0

云数据库 GaussDB
云数据库 GaussDB-日志回放:recovery_min_apply_delay

recovery_min_apply_delay 参数说明：设置备节点回放的延迟时间。该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。此参数主节点设置无效，必须设置在需要延迟的备节点上，推荐设置在异步备上，设置了延时的异步备如果升主RTO时间会比较长。延迟时间是根据主服务器上事务提交的时间戳与备机上的当前时间来计算，因此需要保证主备系统时钟一致。延迟时间设置过长时，可能会导致该备机xLog文件所在的磁盘满，需要平衡考虑磁盘大小来设置延迟时间。没有事务的操作不会被延迟。主备切换之后，原主机若需延迟，需要再手动配置此参数。当synchronous_commit被设置为remote_apply时，同步复制会受到这个延时的影响，每一个COMMIT都需要等待备机回放结束后才会返回。使用这个特性也会让hot_standby_feedback被延迟，这可能导致主服务器的膨胀，两者一起使用时要小心。主机执行了持有AccessExclusive锁的DDL操作，比如DROP和TRUNCATE操作，在备机延迟回放该条记录期间，在备机上对该操作对象执行查询操作会等待锁释放之后才会返回。不支持MOT表。取值范围：整型，0~INT_MAX，单位为毫秒。默认值：0（不增加延迟）

云数据库 GaussDB
云数据库 GaussDB-日志回放:redo_bind_cpu_attr

redo_bind_cpu_attr 参数说明：用于控制回放线程的绑核操作，仅sysadmin用户可以访问。该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。取值范围：字符串，长度大于0，该参数不区分大小写。 'nobind'：线程不做绑核。 'nodebind: 1, 2'：利用NUMA组1,2中的CPU core进行绑核。 'cpubind: 0-30'：利用0-30号CPU core进行绑核。默认值：'nobind'

云数据库 GaussDB
云数据库 GaussDB-安全和认证（postgresql.conf）:ssl

ssl 参数说明：启用SSL连接。请在使用这个选项之前阅读通过gsql连接实例章节。该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。取值范围：布尔型 on表示启用SSL连接。 off表示不启用SSL连接。开启此参数需要同时配置ssl_cert_file、ssl_key_file和ssl_ca_file等参数及对应文件，不正确的配置可能会导致数据库无法正常启动。默认值：on

云数据库 GaussDB
云数据库 GaussDB-通信库参数:comm_proxy_attr

comm_proxy_attr 参数说明：通信代理库相关参数配置。该参数仅支持欧拉2.9系统下的集中式ARM单机。本功能在线程池开启状态下生效，即enable_thread_pool为on。配置该参数时需同步配置GUC参数local_bind_address为libos_kni的网卡IP。参数模板：comm_proxy_attr = '{enable_libnet:true, enable_dfx:false, numa_num:4, numa_bind:[[30,31],[62,63],[94,95],[126,127]]}' 可配置参数说明。 enable_libnet：是否开启用户态协议，取值范围：true、false。 enable_dfx：是否开启通信代理库视图，取值范围：true、false。 numa_num：机器环境中numa的数量，支持2P、4P服务器，取值范围：4、8。 numa_bind：代理线程绑核参数，每个numa两个CPU绑核，共numa_num组，取值范围：[0，cpu数-1]。该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。取值范围：字符串，长度大于0。默认值：'none'

云数据库 GaussDB
云数据库 GaussDB-日志回放:recovery_time_target

recovery_time_target 参数说明：设置recovery_time_target秒能够让备机完成日志写入和回放。该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。取值范围：整型，0~3600（秒） 0是指不开启日志流控，1~3600是指备机能够在recovery_time_target时间内完成日志的写入和回放，可以保证主机与备机切换时能够在recovery_time_target秒完成日志写入和回放，保证备机能够快速升主机。recovery_time_target设置时间过小会影响主机的性能，设置过大会失去流控效果。默认值：60

云数据库 GaussDB
云数据库 GaussDB-日志回放:recovery_redo_workers

recovery_redo_workers 参数说明：是极致RTO特性中每个ParseRedoRecord线程对应的PageRedoWorker数量。该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。取值范围：整型，1~8 需要配合recovery_parse_workers使用。在配合recovery_parse_workers使用时，只有recovery_parse_workers大于0，recovery_redo_workers参数才生效。默认值：1

云数据库 GaussDB
云数据库 GaussDB-通信库参数:tcp_user_timeout

tcp_user_timeout 参数说明：在支持TCP_USER_TIMEOUT套接字选项的操作系统上，设置GaussDB在发送数据时，指定传输的数据在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参数取值示意 Linux TCP重传次数 Linux TCP重传总耗时区间（秒） tcp_user_timeout设置举例（毫秒）实际Linux TCP重传总耗时（秒） 1 (0.2,0.6] 400 0.6 2 (0.6,1.4] 1000 1.4 3 (1.4,3] 2000 3 4 (3,6.2] 4000 6.2 5 (6.2,12.6] 10000 12.6 6 (12.6,25.4] 20000 25.4 7 (25.4,51] 40000 51 8 (51,102.2] 80000 102.2 9 (102.2,204.6] 150000 204.6 10 (204.6,324.6] 260000 324.6 11 (324.6,444.6] 400000 444.6 注：TCP每次重传耗时随重传次数指数增加，当TCP一次重传到达120秒后，后续每次重传都将耗时120秒不再变化。

云数据库 GaussDB
云数据库 GaussDB-通信库参数:tcp_keepalives_interval

tcp_keepalives_interval 参数说明：在支持TCP_KEEPINTVL套接字选项的操作系统上，以秒数声明在重新传输之间等待响应的时间。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：0-180，单位为s。默认值：如果操作系统不支持TCP_KEEPINTVL选项，这个参数的值必须为0。在通过UNIX域套接字进行的连接的操作系统上，这个参数将被忽略。将该值设置为0时，将使用系统的值。该参数在不同的会话之间不共享，也就是说不同的会话连接可能有不同的值。查看该参数时查出来的是当前会话连接内的参数值，而不是GUC副本的值。

云数据库 GaussDB
云数据库 GaussDB-数据导入导出:enable_copy_server_files

enable_copy_server_files 参数说明：是否开启copy服务器端文件的权限。该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。取值范围：布尔型 on表示开启copy服务端文件的权限。 off表示不开启copy服务端文件的权限。默认值：off 当参数enable_copy_server_files关闭时，只允许初始用户执行COPY FROM FILENAME或COPY TO FILENAME命令，当参数enable_copy_server_files打开，允许具有SYSADMIN权限的用户或继承了内置角色gs_role_copy_files权限的用户执行。

云数据库 GaussDB
云数据库 GaussDB-通信库参数:tcp_keepalives_idle

tcp_keepalives_idle 参数说明：在支持TCP_KEEPIDLE套接字选项的系统上，设置发送活跃信号的间隔秒数。不设置发送保持活跃信号，连接就会处于闲置状态。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。如果操作系统不支持TCP_KEEPIDLE选项，这个参数的值必须为0。在通过UNIX域套接字进行的连接的操作系统上，这个参数将被忽略。将该值设置为0时，将使用系统的值。该参数在不同的会话之间不共享，也就是说不同的会话连接可能有不同的值。查看该参数时查出来的是当前会话连接内的参数值，而不是GUC副本的值。取值范围：0-3600，单位为s。默认值：60

云数据库 GaussDB
云数据库 GaussDB-通信库参数:tcp_keepalives_count

tcp_keepalives_count 参数说明：在支持TCP_KEEPCNT套接字选项的操作系统上，设置GaussDB服务端在断开与客户端连接之前可以等待的保持活跃信号个数。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。如果操作系统不支持TCP_KEEPCNT选项，这个参数的值必须为0。在通过UNIX域套接字进行连接的操作系统上，这个参数将被忽略。将该值设置为0时，将使用系统的值。该参数在不同的会话之间不共享，也就是说不同的会话连接可能有不同的值。查看该参数时查出来的是当前会话连接内的参数值，而不是GUC副本的值。取值范围：0-100，其中0表示GaussDB未收到客户端反馈的保持活跃信号则立即断开连接。默认值：20

云数据库 GaussDB
云数据库 GaussDB-查询规划

查询规划介绍查询优化器方法配置、开销常量、规划算法以及一些配置参数。优化器中涉及的两个参数： INT_MAX数据类型INT的最大值，其值为2147483647。 DBL_MAX数据类型FLOAT的最大值。全局设置查询规划相关参数除了客户业务外也会对数据库自身运维和监控业务造成影响，如WDR报告生成、扩容、重分布、数据导入导出等。优化器方法配置优化器开销常量基因查询优化器其他优化器选项父主题： GUC参数说明

云数据库 GaussDB
云数据库 GaussDB-数据导入导出:raise_errors_if_no_files

raise_errors_if_no_files 参数说明：导入时是否区分“导入文件记录数为空”和“导入文件不存在”。raise_errors_if_no_files=TRUE，则“导入文件不存在”的时候，GaussDB将抛出“文件不存在的”错误。该参数属于SUSET类型参数，请参考表1中对应设置方法进行设置。取值范围：布尔型 on表示导入时区分“导入文件记录数为空”和“导入文件不存在”。 off表示导入时不区分“导入文件记录数为空”和“导入文件不存在”。默认值：off

云数据库 GaussDB
云数据库 GaussDB-区域和格式化:lc_monetary

lc_monetary 参数说明：设置货币值的显示格式，影响to_char之类的函数的输出。可接受的值是系统相关的。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：字符串使用命令locale -a查看当前系统支持的区域和相应的编码格式，并可以选择进行设置。默认情况下，gs_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。默认值：C

云数据库 GaussDB
云数据库 GaussDB-区域和格式化:lc_numeric

lc_numeric 参数说明：设置数值的显示格式，影响to_char之类的函数的输出。可接受的值是系统相关的。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：字符串使用命令locale -a查看当前系统支持的区域和相应的编码格式，并可以选择进行设置。默认情况下，gs_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。默认值：C

云数据库 GaussDB
云数据库 GaussDB-区域和格式化:timezone_abbreviations

timezone_abbreviations 参数说明：设置服务器接受的时区缩写值。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：字符串，可查询视图pg_timezone_names获得。默认值：Default Default表示通用时区的缩写, 适合绝大部分情况。但也可设置其他诸如 'Australia' 和 'India' 等用来定义特定的安装。而设置除此之外的时区缩写, 需要在建数据库之前通过相应的配置文件进行设置。

云数据库 GaussDB
云数据库 GaussDB-区域和格式化:IntervalStyle

IntervalStyle 参数说明：设置区间值的显示格式。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：枚举类型 sql_standard表示产生与SQL标准规定匹配的输出。 postgres表示产生与PostgreSQL 8.4版本相匹配的输出，当DateStyle参数被设为ISO时。 postgres_verbose表示产生与PostgreSQL 8.4版本相匹配的输出，当DateStyle参数被设为non_ISO时。 iso_8601表示产生与在ISO 8601中定义的“格式与代号”相匹配的输出。 a表示与numtodsinterval函数相匹配的输出结果。 IntervalStyle参数也会影响不明确的间隔输入的说明。默认值：postgres

云数据库 GaussDB
云数据库 GaussDB-区域和格式化:extra_float_digits

extra_float_digits 参数说明：这个参数为浮点数值调整显示的数据位数，浮点类型包括float4、float8 以及几何数据类型。参数值加在标准的数据位数上（FLT_DIG或DBL_DIG中合适的）。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：整型，-15～3 设置为3，表示包括部分关键的数据位。这个功能对转储那些需要精确恢复的浮点数据特别有用。设置为负数，表示消除不需要的数据位。默认值：0

云数据库 GaussDB
云数据库 GaussDB-区域和格式化:client_encoding

client_encoding 参数说明：设置客户端的字符编码类型。请根据前端业务的情况确定。尽量客户端编码和服务器端编码一致，提高效率。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：兼容PostgreSQL所有的字符编码类型。其中UTF8表示使用数据库的字符编码类型。使用命令locale -a查看当前系统支持的区域和相应的编码格式，并可以选择进行设置。默认情况下，gs_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。参数建议保持默认值，不建议通过gs_guc工具或其他方式直接在postgresql.conf文件中设置client_encoding参数，即使设置也不会生效，以保证数据库内部通信编码格式一致。默认值：UTF8 推荐值：SQL_ASCII/UTF8

云数据库 GaussDB
云数据库 GaussDB-区域和格式化:DateStyle

DateStyle 参数说明：设置日期和时间值的显示格式，以及有歧义的输入值的解析规则。这个变量包含两个独立的加载部分：输出格式声明（ISO、Postgres、SQL、German）和输入输出的年/月/日顺序（DMY、MDY、YMD）。这两个可以独立设置或者一起设置。关键字Euro和European等价于DMY；关键字US、NonEuro、NonEuropean等价于MDY。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：字符串默认值：ISO, MDY gs_initdb会将这个参数初始化成与lc_time一致的值。设置建议：优先推荐使用ISO格式。Postgres、SQL和German均采用字母缩写的形式来表示时区，例如“EST、WST、 CS T”等。这些缩写可同时指代不同的时区，比如CST可同时代表美国中部时间(Central Standard Time (USA) UT-6:00)、澳大利亚中部时间(Central Standard Time (Australia) UT+9:30)、中国标准时间(China Standard Time UT+8:00)。这种情况下在时区转化时可能会得不到正确的结果，从而引发其他问题。

云数据库 GaussDB
云数据库 GaussDB-区域和格式化:lc_messages

lc_messages 参数说明：设置信息显示的语言。可接受的值是与系统相关的。在一些系统上，这个区域范畴并不存在，不过仍然允许设置这个变量，只是不会有任何效果。同样，也有可能是所期望的语言的翻译信息不存在。在这种情况下，用户仍然能看到英文信息。该参数属于SUSET类型参数，请参考表1中对应设置方法进行设置。取值范围：字符串使用命令locale -a查看当前系统支持的区域和相应的编码格式，并可以选择进行设置。默认情况下，gs_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。默认值：C

云数据库 GaussDB
云数据库 GaussDB-区域和格式化:lc_time

lc_time 参数说明：设置时间和区域的显示格式，影响to_char之类的函数的输出。可接受的值是系统相关的。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：字符串使用命令locale -a查看当前系统支持的区域和相应的编码格式，并可以选择进行设置。默认情况下，gs_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。默认值：C

云数据库 GaussDB
云数据库 GaussDB-用户和权限审计:audit_login_logout

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

云数据库 GaussDB
云数据库 GaussDB-用户和权限审计:audit_database_process

audit_database_process 参数说明：该参数决定是否对GaussDB的启动、停止、切换和恢复进行审计。该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。取值范围：整型，0、1。 0表示关闭GaussDB启动、停止、恢复和切换审计功能。 1表示开启GaussDB启动、停止、恢复和切换审计功能。默认值：1 数据库启动时DN走备升主流程，因此DN启动时审计日志中类型为system_switch。

云数据库 GaussDB
云数据库 GaussDB-归档:archive_timeout

archive_timeout 参数说明：表示归档周期。该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。超过该参数设定的时间时强制切换WAL段。由于强制切换而提早关闭的归档文件仍然与完整的归档文件长度相同。因此，将archive_timeout设为很小的值将导致占用巨大的归档存储空间，建议将archive_timeout设置为60秒。取值范围：整型，0 ~ 1073741823，单位为秒。其中0表示禁用该功能。默认值：0

云数据库 GaussDB
云数据库 GaussDB-归档:time_to_target_rpo

time_to_target_rpo 参数说明：双数据库实例异地灾备模式下，设置主数据库实例发生异常发生时到已归档到OBS的恢复点所允许的time_to_target_rpo秒。该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。取值范围：整型，0~3600（秒）双数据库实例异地灾备模式下，主数据库实例日志将被归档到OBS。0是指不开启日志流控，1~3600是指设置主数据库实例发生异常发生时到已归档到OBS的恢复点所允许的time_to_target_rpo秒，保证主数据库实例因灾难崩溃时，最多可能丢失的数据的时长在允许范围内。time_to_target_rpo设置时间过小会影响主机的性能，设置过大会失去流控效果。默认值：0

云数据库 GaussDB
云数据库 GaussDB-cm_agent参数:dilatation_shard_count_for_disk_capacity_alarm

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

云数据库 GaussDB

共99354条

undefined

意见反馈

0/200

提交取消

提交成功！非常感谢您的反馈，我们会继续努力做到更好反馈提交失败！请稍后重试！

华为云用户手册

7*24

备案

专业服务

退订

建议反馈

售前咨询热线