华为云用户手册

云数据库 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-升级参数:upgrade_mode

upgrade_mode 参数说明：升级模式。该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。取值范围：整数，0~INT_MAX 0表示不在升级过程中。 1表示在就地升级过程中。 2表示在灰度升级过程中。默认值：0 特殊情况：在使用灰度升级的情况下，若选择策略为大版本升级，即需要执行升级脚本和替换二进制包，会将upgrade_mode设置为2，选择策略为小版本升级，只替换二进制包，则不会设置upgrade_mode设置为2。

云数据库 GAUSSDB
云数据库 GAUSSDB-发送端服务器:enable_wal_shipping_compression

enable_wal_shipping_compression 参数说明：在流式容灾模式下设置启动跨数据库实例日志压缩功能。该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。该参数仅作用于流式容灾中跨数据库实例传输的一对walsender与walreceiver中，在主数据库实例上配置。取值范围：布尔型 true表示打开流式容灾跨数据库实例日志压缩 false表示关闭流式容灾跨数据库实例日志压缩默认值：false

云数据库 GAUSSDB
云数据库 GAUSSDB-发送端服务器:repl_uuid

repl_uuid 参数说明：设置用于主备UUID验证的UUID码。该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。如果主机上开启了UUID验证功能、且配置了非空字符串的repl_uuid验证码，那么备机也需要开启UUID验证功能、且配置相同的repl_uuid验证码，否则主备日志复制和备机重建请求将被主机拒绝。该参数支持SIGHUP动态加载新值。修改之后，不影响已建连的主备连接，对后续主备复制请求和主备重建请求生效。支持Quorum、DCF协议下的备机重建验证；支持Quorum协议下的主备复制验证；不支持DCF协议下的主备复制验证。不支持跨数据库实例主、备之间的认证，包括Dorado主备实例和容灾主备实例。 UUID验证功能主要为了防止主、备误连导致的数据串扰和污染，不是用于安全目的。该参数不支持主、备间自动同步。取值范围：字符串类型。长度0 – 63个字符，字母和数字的组合，大小写不敏感，内部统一转换为小写存储。空字符串表示不启用UUID验证功能。默认值：空字符串

云数据库 GAUSSDB
云数据库 GAUSSDB-发送端服务器:repl_auth_mode

repl_auth_mode 参数说明：设置主备复制和备机重建的验证模式。该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。如果主机上开启了UUID验证功能、且配置了非空字符串的repl_uuid验证码，那么备机也需要开启UUID验证功能、且配置相同的repl_uuid验证码，否则主备日志复制和备机重建请求将被主机拒绝。该参数支持SIGHUP动态加载新值。修改之后，不影响已建连的主备连接，对后续主备复制请求和主备重建请求生效。支持Quorum、DCF协议下的备机重建验证；支持Quorum协议下的主备复制验证；不支持DCF协议下的主备复制验证。不支持跨数据库实例主、备之间的认证，包括Dorado主备实例和容灾主备实例。 UUID验证功能主要为了防止主、备误连导致的数据串扰和污染，不是用于安全目的。该参数不支持主、备间自动同步。取值范围：枚举类型 off 表示关闭UUID验证功能。 default 表示关闭UUID验证功能。 uuid 表示开启UUID验证功能。默认值：default

云数据库 GAUSSDB
云数据库 GAUSSDB-发送端服务器:logical_decode_options_default

logical_decode_options_default 参数说明：指定逻辑解码启动时未指定解码选项的全局默认值。该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。当前支持指定的逻辑解码选项包括：parallel-decode-num, parallel-queue-size, max-txn-in-memory, max-reorderbuffer-in-memory，exclude-users。取值范围：通过逗号分隔的key=value字符串，例如：'parallel-decode-num=4,parallel-queue-size=128,exclude-users=userA'。其中空字符串表示采用程序硬编码的默认值。默认值：空字符串该参数SIGHUP生效并不会影响已经启动的逻辑解码流程；后续逻辑解码启动将使用该参数设置的选项作为其默认配置，并优先使用启动命令中指定选项的设置。这里exclude-users选项和逻辑解码启动选项存在差异，不允许指定多个黑名单用户。

云数据库 GAUSSDB
云数据库 GAUSSDB-发送端服务器:max_wal_senders

max_wal_senders 参数说明：指定事务日志发送进程的并发连接最大数量。不可大于等于max_connections。该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 wal_level必须设置为archive、hot_standby或者logical以允许备机的连接。取值范围：整型，0 ～ 1024（建议取值范围：8 ~ 100）只有当使用单DN实例无主备场景下才可以设置0。默认值：20

云数据库 GAUSSDB
云数据库 GAUSSDB-发送端服务器:wal_keep_segments

wal_keep_segments 参数说明：xLog日志文件段数量。设置“pg_xlog”目录下保留事务日志文件的最小数目，备机通过获取主机的日志进行流复制。该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。取值范围：整型，2 ~ INT_MAX 默认值：1024 设置建议：当服务器开启日志归档或者从检查点恢复时，保留的日志文件数量可能大于wal_keep_segments设定的值。如果此参数设置过小，则在备机请求事务日志时，此事务日志可能已经被产生的新事务日志覆盖，导致请求失败，主备关系断开。当双机为异步传输时，以COPY方式连续导入4G以上数据需要增大wal_keep_segments配置。以T6000单板为例，如果导入数据量为50G，建议调整参数为1000。您可以在导入完成并且日志同步正常后，动态恢复此参数设置。若synchronous_commit级别小于LOCAL_FLUSH，重建备机时，建议调大该参数为1000，避免重建过程中，主机日志回收导致重建失败。

云数据库 GAUSSDB
云数据库 GAUSSDB-发送端服务器:wal_sender_timeout

wal_sender_timeout 参数说明：设置本端等待事务日志接收端接收日志的最大等待时间。该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。如果主机数据较大，重建备机数据库时需要增大此参数的值，主机数据在500G时，此参数的参考值为600s。此值不能大于wal_receiver_timeout或数据库重建时的超时参数。取值范围：整型，0 ~ INT_MAX，单位为毫秒（ms）。默认值：6s

云数据库 GAUSSDB
云数据库 GAUSSDB-发送端服务器:max_replication_slots

max_replication_slots 参数说明：设置主机端的日志复制slot个数。该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。取值范围：整型，0~1024（建议取值范围：8~100）默认值：20 设置建议：当使用双机复制、备份恢复、逻辑解码时，该参数值建议设为：当前物理流复制槽数+备份槽数+所需的逻辑复制槽数。如果实际设置值比上述建议值要小，那么可能造成这些功能不可用或异常。物理流复制槽提供了一种自动化的方法来确保主节点在所有备节点收到xLog之前，xLog不会被移除。也就是说物理流复制槽用于支撑主备HA。数据库所要的物理流复制槽数为备节点和与主节点之间的比例。例如，假设数据库高可用方案为1主、2备，则所需物理流复制槽数为2。假设数据库的高可用方案为1主3备，则所需物理流复制槽数为3。备份槽：记录备份执行过程中的一些复制信息，全量备份和增量备份各自对应单独的备份槽，共2个。关于逻辑复制槽数，请按如下规则考虑：一个逻辑复制槽只能解码一个数据库的修改，如果需要解码多个数据库，则需要创建多个逻辑复制槽。如果需要多路逻辑复制同步给多个目标数据库，在源端数据库需要创建多个逻辑复制槽，每个逻辑复制槽对应一条逻辑复制链路。

云数据库 GAUSSDB
云数据库 GAUSSDB-自动清理:autovacuum_freeze_max_age

autovacuum_freeze_max_age 参数说明：设置事务内的最大时间，使得表的pg_class.relfrozenxid字段在VACUUM操作执行之前被写入。 VACUUM也可以删除pg_clog/子目录中的旧文件。即使自动清理线程被禁止，系统也会调用自动清理线程来防止循环重复。该参数属于POSTMASTER类型参数，请参考表2中对应设置方法进行设置。取值范围：长整型，100 000～576 460 752 303 423 487 默认值：4000000000

云数据库 GAUSSDB
云数据库 GAUSSDB-自动清理:autovacuum_mode

autovacuum_mode 参数说明：该参数仅在autovacuum设置为on的场景下生效，它控制autoanalyze或autovacuum的打开情况。该参数属于SIGHUP类型参数，请参考表2中对应设置方法进行设置。取值范围：枚举类型 analyze表示只做autoanalyze。 vacuum表示只做autovacuum。 mix表示autoanalyze和autovacuum都做。 none表示二者都不做。默认值：mix

云数据库 GAUSSDB
云数据库 GAUSSDB-自动清理:log_autovacuum_min_duration

log_autovacuum_min_duration 参数说明：当自动清理的执行时间大于或者等于某个特定的值时，向服务器日志中记录自动清理执行的每一步操作。设置此选项有助于追踪自动清理的行为。该参数属于SIGHUP类型参数，请参考表2中对应设置方法进行设置。举例如下：将log_autovacuum_min_duration设置为250ms，记录所有运行大于或者等于250ms的自动清理命令的相关信息。取值范围：整型，最小值为-1，最大值为2147483647，单位为毫秒。当参数设置为0时，表示所有的自动清理操作都记录到日志中。当参数设置为-1时，表示所有的自动清理操作都不记录到日志中。当参数设置为大于0时，当由于锁冲突的存在导致一个自动清理操作被跳过，记录一条消息。默认值：-1

云数据库 GAUSSDB
云数据库 GAUSSDB-自动清理:autovacuum_max_workers

autovacuum_max_workers 参数说明：设置能同时运行的自动清理线程的最大数量，该参数的取值上限与GUC参数max_connections和job_queue_processes大小有关。该参数属于POSTMASTER类型参数，请参考表2中对应设置方法进行设置。取值范围：整型，最小值为0（表示不会自动进行autovacuum），理论最大值为262143，实际最大值为动态值，计算公式为“262143 - max_connections - job_queue_processes - 辅助线程数 – autovacuum的launcher线程数 - 1”，其中辅助线程数和autovacuum的launcher线程数由两个宏来指定，当前版本的默认值分别为20和2。默认值：3

云数据库 GAUSSDB
云数据库 GAUSSDB-自动清理:autovacuum

autovacuum 参数说明：控制数据库自动清理线程（autovacuum）的启动。自动清理线程运行的前提是将track_counts设置为on。该参数属于SIGHUP类型参数，请参考表2中对应设置方法进行设置。如果希望系统在故障恢复后，具备自动清理两阶段事务的功能，请将autovacuum设置为on; 当设置autovacuum为on，autovacuum_max_workers为0时，表示系统不会自动进行autovacuum，只会在故障恢复后，自动清理两阶段事务；当设置autovacuum为on，autovacuum_max_workers大于0时，表示系统不仅在故障恢复后，自动清理两阶段事务，并且还可以自动清理线程。取值范围：布尔型 on表示开启数据库自动清理线程。 off表示关闭数据库自动清理线程。默认值：on

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

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

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

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

云数据库 GAUSSDB
云数据库 GAUSSDB-语句行为:vacuum_freeze_min_age

vacuum_freeze_min_age 参数说明：指定VACUUM在扫描一个表时用于判断是否用FrozenXID替换记录的xmin字段（在同一个事务中）。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：整型，0 ～ 576 460 752 303 423 487 尽管随时可以将此参数设为上述取值范围之间的任意值，但是，VACUUM将默认其有效值范围限制在autovacuum_freeze_max_age的50%以内。默认值：2000000000

云数据库 GAUSSDB
云数据库 GAUSSDB-语句行为:vacuum_freeze_table_age

vacuum_freeze_table_age 参数说明：指定VACUUM对全表的扫描冻结元组的时间。如果当前事务号与表pg_class.relfrozenxid64字段的差值已经大于参数指定的时间时，VACUUM对全表进行扫描。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：整型，0～576 460 752 303 423 487 尽管随时可以将此参数设为上述取值范围之间的值，但是，VACUUM将默认其有效值范围限制在autovacuum_freeze_max_age的95%以内。定期的手动VACUUM可以在对此表的反重叠自动清理启动之前运行。默认值：4000000000

云数据库 GAUSSDB
云数据库 GAUSSDB-语句行为:session_replication_role

session_replication_role 参数说明：控制当前会话与复制相关的触发器和规则的行为。该参数属于SUSET类型参数，请参考表1中对应设置方法进行设置。设置此参数会丢弃之前任何缓存的执行计划。取值范围：枚举类型 origin表示从当前会话中复制插入、删除、更新等操作。 replica表示从其他地方复制插入、删除、更新等操作到当前会话。 local表示函数执行复制时会检测当前登录数据库的角色并采取相应的操作。默认值：origin

云数据库 GAUSSDB
云数据库 GAUSSDB-语句行为:check_function_bodies

check_function_bodies 参数说明：设置是否在CREATE FUNCTION执行过程中进行函数体字符串的合法性验证。为了避免产生问题（比如避免从转储中恢复函数定义时向前引用的问题），偶尔会禁用验证。开启后主要验证存储过程中PL/SQL的词语法问题，包括数据类型、语句和表达式等，对于其中出现的SQL则在Create阶段不做检查而采用了运行时检查的方式。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：布尔型 on表示在CREATE FUNCTION执行过程中进行函数体字符串的合法性验证。 off表示在CREATE FUNCTION执行过程中不进行函数体字符串的合法性验证。默认值：on

云数据库 GAUSSDB
云数据库 GAUSSDB-语句行为:default_transaction_isolation

default_transaction_isolation 参数说明：设置默认的事务隔离级别。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。当前版本暂不支持设置默认的事务隔离级别，默认为read committed，请勿自行修改。取值范围：枚举类型 read committed表示事务读已提交。 repeatable read表示事务可重复读。 serializable，GaussDB目前功能上不支持此隔离级别，等价于repeatable read。默认值：read committed

云数据库 GAUSSDB
云数据库 GAUSSDB-语句行为:current_schema

current_schema 参数说明：此参数设置当前的模式。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：字符串默认值："$user",public $user表示与当前会话用户名同名的模式名，如果这样的模式不存在，$user将被忽略。 GaussDB开发过程中如需要获取Schema，请使用search_path对应的值，因为Schema是search_path决定的。为了兼容性A数据库，current_schema目的只是作为修改search_path的值使用。

云数据库 GAUSSDB
云数据库 GAUSSDB-语句行为:default_tablespace

default_tablespace 参数说明：当CREATE命令没有明确声明表空间时，所创建对象（表和索引等）的缺省表空间。值是一个表空间的名称或者一个表示使用当前数据库缺省表空间的空字符串。若指定的是一个非默认表空间，用户必须具有它的CREATE权限，否则尝试创建会失败。临时表不使用此参数，可以用temp_tablespaces代替。创建数据库时不使用此参数。默认情况下，一个新的数据库从模板数据库继承表空间配置。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：字符串，其中空表示使用默认表空间。默认值：空

云数据库 GAUSSDB
云数据库 GAUSSDB-语句行为:temp_tablespaces

temp_tablespaces 参数说明：当一个CREATE命令没有明确指定一个表空间时，temp_tablespaces指定了创建临时对象（临时表和临时表的索引）所在的表空间。在这些表空间中创建临时文件用来做大型数据的排序工作。其值是一系列表空间名的列表。如果列表中有多个表空间时，每次临时对象的创建，GaussDB会在列表中随机选择一个表空间；如果在事务中，连续创建的临时对象被放置在列表里连续的表空间中。如果选择的列表中的元素是一个空串，GaussDB将自动将当前的数据库设为默认的表空间。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：字符串。空字符串表示所有的临时对象仅在当前数据库默认的表空间中创建，请参见default_tablespace。默认值：空

云数据库 GAUSSDB
云数据库 GAUSSDB-语句行为:search_path

search_path 参数说明：当一个被引用对象没有指定模式时，此参数设置模式搜索顺序。它的值由一个或多个模式名构成，不同的模式名用逗号隔开。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。当前会话如果存放临时表的模式时，可以使用别名pg_temp将它列在搜索路径中，如'pg_temp，public'。存放临时表的模式始终会作为第一个被搜索的对象，排在pg_catalog和search_path中所有模式的前面，即具有第一搜索优先级。建议用户不要在search_path中显示设置pg_temp。如果在search_path中指定了pg_temp，但不是在最前面，系统会提示设置无效，pg_temp仍被优先搜索。通过使用别名pg_temp，系统只会在存放临时表的模式中搜索表、视图和数据类型这样的数据库对象，不会在里面搜索函数或运算符这样的数据库对象。系统表所在的模式pg_catalog，总是排在search_path中指定的所有模式前面被搜索，即具有第二搜索优先级（pg_temp具有第一搜索优先级）。建议用户不要在search_path中显式设置pg_catalog。如果在search_path中指定了pg_catalog，但不是在最前面，系统会提示设置无效，pg_catalog仍被第二优先搜索。当没有指定一个特定模式而创建一个对象时，它们被放置到以search_path为命名的第一个有效模式中。当搜索路径为空时，会报错误。通过SQL函数current_schema可以检测当前搜索路径的有效值。这和检测search_path的值不尽相同，因为current_schema显示search_path中首位有效的模式名称。取值范围：字符串设置为"$user"，public时，支持共享数据库（没有用户具有私有模式和所有共享使用public），用户私有模式和这些功能的组合使用。可以通过改变默认搜索路径来获得其他效果，无论是全局化的还是私有化的。设置为空串（''）的时候，系统会自动转换成一对双引号。设置的内容中包含双引号，系统会认为是不安全字符，会将每个双引号转换成一对双引号。默认值："$user",public $user表示与当前会话用户名同名的模式名，如果这样的模式不存在，$user将被忽略。

云数据库 GAUSSDB
云数据库 GAUSSDB-异步I/O:checkpoint_flush_after

checkpoint_flush_after 参数说明：设置checkpointer线程刷页个数超过设定的阈值时，告知操作系统开始将操作系统缓存中的页面异步刷盘。GaussDB中，磁盘页大小为8KB。该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。取值范围：整型，0~256（0表示关闭异步刷盘功能）。例如，取值32，表示checkpointer线程连续写32个磁盘页，即32*8=256KB磁盘空间后会进行异步刷盘。默认值：256KB

云数据库 GAUSSDB
云数据库 GAUSSDB-异步I/O:bgwriter_flush_after

bgwriter_flush_after 参数说明：设置background writer线程刷页个数超过设定的阈值时，告知操作系统开始将操作系统缓存中的页面异步刷盘。GaussDB中，磁盘页大小为8KB。该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。取值范围：整型，0~256（0表示关闭异步刷盘功能），单位页面（8KB）。例如，取值64，表示background writer线程连续写64个磁盘页，即64*8=512KB磁盘空间后会进行异步刷盘。默认值：512KB（即64个页面）

云数据库 GAUSSDB
云数据库 GAUSSDB-异步I/O:backend_flush_after

backend_flush_after 参数说明：设置backend线程刷页个数超过设定的阈值时，告知操作系统开始将操作系统缓存中的页面异步刷盘。GaussDB中，磁盘页大小为8KB。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：整型，0~256（0表示关闭异步刷盘功能），单位页面（8KB）。例如，取值64，表示backend线程连续写64个磁盘页，即64*8=512KB磁盘空间后会进行异步刷盘。默认值：0

云数据库 GAUSSDB
云数据库 GAUSSDB-优化器开销常量:random_page_cost

random_page_cost 参数说明：设置优化器计算一次非顺序抓取磁盘页面的开销。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。虽然服务器允许将random_page_cost设置的比seq_page_cost小，但是物理上实际不受影响。如果所有数据库都位于随机访问内存中时，两者设置为相等很合理。因为在此种情况下，非顺序抓取页并没有副作用。同样，在缓冲率很高的数据库上，应该相对于CPU参数同时降低这两个值，因为获取内存中的页要比通常情况下开销小很多。取值范围：浮点型，0～DBL_MAX。默认值：4 对于特别表空间中的表和索引，可以通过设置同名的表空间的参数来覆盖这个值。相对于seq_page_cost，减少这个值将导致系统更倾向于使用索引扫描，而增加这个值使得索引扫描开销比较高。可以通过同时增加或减少这两个值来调整磁盘I/O相对于CPU的开销。

云数据库 GAUSSDB

共100000条

undefined

意见反馈

0/200

提交取消

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