华为云用户手册

ssl_cert_notify_time 参数说明：SSL服务器证书到期前提醒的天数。建立连接初始化ssl证书时，若当前时间距离证书到期时间小于设定值，则在日志中打印过期提醒。 参数类型：整型 参数单位：d（天） 取值范围：7 ~ 180 默认值：90 设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。取值如果要带单位，必须为d。 设置建议：推荐使用默认值。 设置不当的风险与影响：参数设置过小，可能导致服务端证书过期没有被提前感知，导致无法及时更换证书；设置过大，可能导致频繁告警。

ssl_crl_file 参数说明：指定包含证书吊销列表的文件的名称，如果客户端证书在该列表中，则当前客户端证书被视为无效证书。必须使用相对路径，相对路径是相对于数据目录的。 参数类型：字符串 参数单位：无 取值范围：合法文件名称，空字符串表示没有吊销列表。 默认值："" 设置方式：该参数属于POSTMASTER类型参数，请参见表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：若吊销列表中文件名称配置错误，可能导致无效的客户端证书可完成SSL建连，存在数据泄露风险；有效的客户端证书被视为已吊销，无法建立SSL连接。

enable_shared_sslctx 参数说明：是否开启SSL证书全局加载并共享SSL上下文，仅在SSL参数配置为on时生效。 参数类型：布尔型 参数单位：无 取值范围： on：表示开启SSL证书全局加载，仅在数据库启动时进行一次SSL上下文初始化动作。 off：表示关闭SSL证书全局加载，每次会话建连时均进行SSL上下文初始化动作。 默认值：off 设置方式：该参数属于POSTMASTER类型参数，请参见表1中对应设置方法进行设置。 设置建议：大多数场景下建议关闭；仅在对SSL非双向认证场景的性能要求极高时，建议开启。 设置不当的风险与影响：SSL证书全局加载功能生效后，替换证书无法实时生效，需要重启数据库。 若数据库启动阶段，SSL全局上下文初始化失败，那么该参数会被自动置为off，降级为会话级SSL证书加载。

modify_initial_password 参数说明：当 GaussDB安装 成功后，数据库中仅存在一个初始用户（UID为10的用户）。该参数控制的是，客户通过该账户初次登录数据库进行操作时，是否要对该初始账户的密码进行修改。 如果安装过程中未指定初始用户密码，则安装后初始用户密码默认为空，执行其他操作前需要先通过gsql客户端设置初始用户的密码。此参数功能不再生效，保留此参数仅为兼容升级场景。 参数类型：布尔型 参数单位：无 取值范围： on：表示数据库安装成功后初始用户首次登录操作前需要修改初始密码。 off：表示数据库安装成功后初始用户无需修改初始密码即可进行操作。 默认值：off 设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

ssl_ca_file 参数说明：指定包含CA信息的根证书名称，其相对路径是相对于数据目录的。 参数类型：字符串 参数单位：无 取值范围：合法文件名称，需要以“.pem”结尾。其中空字符串表示没有CA文件被加载，不进行客户端证书验证。 默认值："cacert.pem" 设置方式：该参数属于POSTMASTER类型参数，请参见表1中对应设置方法进行设置。 设置建议：需要进行客户端证书验证时，请正确配置文件路径。 设置不当的风险与影响：文件路径错误时，会导致数据库无法校验客户端证书，通信安全性降低。

ssl_enc_key_file 参数说明：指定包含SSL服务器国密加密证书私钥的文件的名称，其相对路径是相对于数据目录的。 参数类型：字符串 参数单位：无 取值范围：合法文件名称，需要以“.key”结尾。 默认值："" 设置方式：该参数属于POSTMASTER类型参数，请参见表1中对应设置方法进行设置。 设置建议：配置文件路径时，需要确保其与其余国密SSL相关证书/私钥配置文件是配套关系。 设置不当的风险与影响：文件路径错误时，会导致客户端与服务器无法建立国密SSL连接，数据库实例主备节点间无法进行国密SSL通信，数据存在泄漏风险。

password_policy 参数说明：该参数控制的是，在使用CREATE ROLE/USER或者ALTER ROLE/USER命令创建或者修改 GaussDB 账户时，是否进行密码复杂度检查。 参数类型：整型 参数单位：无 取值范围：0、1 0：表示不采用密码复杂度校验策略。 1：表示采用默认密码复杂度校验策略。 默认值：1 设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。 设置建议：从安全性考虑，请勿关闭密码复杂度策略。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

idle_in_transaction_timeout 参数说明：表明与服务器建立连接并开启事务后，事务空闲并不进行任何操作的最长时间。当该参数取值不为0，事务空闲并不进行任何操作的时间超过该参数取值后，会与服务器断开连接。多租场景下，该参数可在PDB级别设置。 参数类型：整型 参数单位：s（秒） 取值范围：0 ~ 86400（1d） 0表示关闭超时设置。 正数表示与服务器建立连接并开启事务后，事务空闲并不进行任何操作的最长时间。当超过设定的值后，会与服务器断开连接。 默认值：300（即5min）。在PDB场景内，若未设置该参数，则继承来自全局的设置。 设置方式：该参数属于USERSET类型参数，请参见表1中对应设置方法进行设置。例如，不带单位取值600，表示idle_in_transaction_timeout为600s；带单位取值10min，表示idle_in_transaction_timeout为10min。取值如果要带单位，必须为s、min、h、d。 设置建议：参数值设置越小越安全，但用户使用越不便，依据业务安全诉求设定。 设置不当的风险与影响：参数设置过小，可能会使得事务开启后，客户端应用在运行过程中没有及时发送新的请求，从而导致会话超时退出，影响用户使用。 GaussDB gsql客户端中有自动重连机制，所以针对初始化用户本地连接，超时后gsql表现的现象为断开后重连。 idle_in_transaction_timeout与session_timeout同时开启时，在事务空闲状态下都会生效，以配置较小的超时时间为准。 新下发实例该参数取值为300，升级实例默认为0。 空闲事务超时后，日志中会打印事务的开始时间、线程id、应用名以及query等信息。该日志用于空闲事务超时退出问题定位，不包含前缀格式log_line_prefix。

ssl_ciphers 参数说明：指定SSL支持的加密算法列表，仅sysadmin用户可以访问。 参数类型：字符串 参数单位：无 取值范围：字符串，如果指定多个加密算法，加密算法之间需要以分号（;）分隔。 默认值："ALL"，表示允许对端使用产品支持的所有加密算法，但不包含ADH、LOW、EXP、MD5算法。 设置方式：该参数属于POSTMASTER类型参数，请参见表1中对应设置方法进行设置。 设置建议：不建议指定不安全算法DHE-RSA-AES128-GCM-SHA256和DHE-RSA-AES256-GCM-SHA384。 设置不当的风险与影响：ssl_ciphers设置错误会导致数据库不能正常启动。

session_timeout 参数说明：表明与服务器建立连接后，不进行任何操作的最长时间。当该参数取值不为0，用户不进行任何操作的时间超过该参数取值后，会与服务器断开连接。该参数可在PDB级别设置。 参数类型：整型 参数单位：s（秒） 取值范围：0 ~ 86400（1d） 0表示关闭超时设置。 正数表示与服务器建立连接后，不进行任何操作的最长时间。当超过设定的值后，会与服务器断开连接。 默认值：600。在PDB场景内，若未设置该参数，则继承来自全局的设置。 设置方式：该参数属于USERSET类型参数，请参见表1中对应设置方法进行设置。例如，不带单位取值600，表示session_timeout为600s；带单位取值10min，表示session_timeout为10min。取值如果要带单位，必须为s、min、h、d。 设置建议：参数值设置越小越安全，但用户使用越不便，依据业务安全诉求设定。 设置不当的风险与影响：设置过小可能造成业务连接池中长连接失效，进而导致业务失败。 GaussDB gsql客户端中有自动重连机制，所以针对初始化用户本地连接，超时后gsql表现的现象为断开后重连。

ssl_key_file 参数说明：指定包含SSL私钥的文件的名称，其相对路径是相对于数据目录的。 参数类型：字符串 参数单位：无 取值范围：合法文件名称，需要以“.key”结尾。 默认值："server.key" 设置方式：该参数属于POSTMASTER类型参数，请参见表1中对应设置方法进行设置。 设置建议：配置文件路径时，需要确保其与其余SSL相关证书/私钥配置文件是配套关系。 设置不当的风险与影响：文件路径错误时，会导致客户端与服务器无法建立SSL连接，数据库实例主备节点间无法SSL通信，数据存在泄漏风险。

ssl_enc_cert_file 参数说明：指定包含SSL服务器国密加密证书的文件的名称，其相对路径是相对于数据目录的。 参数类型：字符串 参数单位：无 取值范围：合法文件名称，需要以“.crt”结尾。 默认值："" 设置方式：该参数属于POSTMASTER类型参数，请参见表1中对应设置方法进行设置。 设置建议：配置文件路径时，需要确保其与其余国密SSL相关证书/私钥配置文件是配套关系。 设置不当的风险与影响：文件路径错误时，会导致客户端与服务器无法建立国密SSL连接，数据库实例主备节点间无法进行国密SSL通信，数据存在泄漏风险。

ssl_renegotiation_limit 参数说明：指定在会话密钥重新协商之前，通过SSL加密通道可以传输的流量。这个重新协商流量限制机制可以减少攻击者针对大量数据使用密码分析法破解密钥的几率，但是也带来较大的性能损失。流量是指发送和接受的流量总和。该参数可在PDB级别设置。 参数类型：整型 参数单位：kB 取值范围：0 ~ 2147483647。其中0表示禁用重新协商机制。 默认值：0。在PDB场景内，若未设置该参数，则继承来自全局的设置。 设置方式：该参数属于USERSET类型参数，请参见表1中对应设置方法进行设置。例如，不带单位取值1024，表示ssl_renegotiation_limit为1024kB；带单位取值1MB，表示ssl_renegotiation_limit为1MB。取值如果要带单位，必须为kB、MB、GB。 设置建议：建议不做修改。使用SSL重协商机制可能引入其他风险，因此已禁用SSL重协商机制，为保持版本兼容保留此参数，修改参数配置不再起作用。 设置不当的风险与影响：修改该参数取值可能导致数据库出现意料之外的结果，请保持默认值。

ssl_cert_file 参数说明：指定包含SSL服务器证书的文件的名称，其相对路径是相对于数据目录的。 参数类型：字符串 参数单位：无 取值范围：合法文件名称，需要以“.crt”结尾。 默认值："server.crt" 设置方式：该参数属于POSTMASTER类型参数，请参见表1中对应设置方法进行设置。 设置建议：配置文件路径时，需要确保其与其余SSL相关证书/私钥配置文件是配套关系。 设置不当的风险与影响：文件路径错误时，会导致客户端与服务器无法建立SSL连接，数据库实例主备节点间无法SSL通信，数据存在泄漏风险。

auth_iteration_count 参数说明：认证加密信息生成过程中使用的迭代次数。 参数类型：整型 参数单位：无 取值范围：2048 ~ 134217728 默认值：10000 设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。 设置建议：请根据实际硬件条件合理设置迭代次数，推荐采用默认迭代次数。 设置不当的风险与影响：迭代次数设置过小会降低口令存储的安全性，设置过大会导致认证、用户创建等涉及口令加密的场景性能劣化。

authentication_timeout 参数说明：完成客户端认证的最长时间。如果一个客户端没有在这段时间里完成与服务器端的认证，则服务器自动中断与客户端的连接，这样就避免了出问题的客户端无限制地占用连接数。 参数类型：整型 参数单位：s（秒） 取值范围：1 ~ 600 默认值：60 设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。例如，不带单位取值600，表示authentication_timeout为600s；带单位取值10min，表示authentication_timeout为10min。取值如果要带单位，必须为s、min、h、d。 设置建议：推荐使用默认值。 设置不当的风险与影响：参数设置过小，可能会导致频繁遇到连接失败，影响用户使用。参数设置过大，会导致安全风险增加、资源浪费等问题。

ecpg预处理以及编译执行 准备嵌入式SQL-C源程序，以.pgc为后缀名，ecpg负责将其转换成可被编译器编译的C语言程序。 生成的C语言程序被编译器编译为可执行文件，运行该可执行文件实现客户端程序访问数据库。示例请参见常用示例章节。 ecpg预处理以及编译处理过程 预处理：ecpg -I $GAUSSHOME/include -o test.c test.pgc ecpg预处理的参数选项如下： ecpg [OPTION]... 其中OPTION参数选项如下： -o OUTFILE：预处理嵌入式SQL-C程序将结果写入OUTFILE，OUTFILE为C语言文件。 -I DIRECTORY：头文件的搜索路径。 -c：预处理嵌入式SQL-C程序自动生成C语言文件。 --version：查看ecpg当前版本。 -C MODE：指定预处理兼容模式，“A”为O兼容。 -r OPTION：指定运行时的行为。OPTION可以是：no_indicator、prepare、questionmarks或with_hold。 no_indicator：使用特殊值来表示空值。 prepare：在使用语句之前先prepare所有语句。 questionmarks：允许使用问号作为占位符。 with_hold：游标创建不带HOLD关键字，默认值为WITH HOLD（该功能需要ecpg和内核版本一致）。 编译：gcc -I $GAUSSHOME/include/ecpg -I $GAUSSHOME/include -I $GAUSSHOME/include/gaussdb/server/ -L $GAUSSHOME/lib -lecpg -lrt -lpq -lpgtypes -lpthread test_ecpg.c -o test_ecpg 执行：./test ecpg作为编译预处理工具，若在预处理或编译过程中出现找不到头文件或者函数实现的报错信息，可以根据需要指定头文件，或者链接动态库。 ecpg需要gcc、ld等编译预处理工具，建议gcc使用7.3.0版本。 使用ecpg开发应用程序所依赖的其他动态库和头文件，常见的位于$GAUSSHOME/include/libpq, $GAUSSHOME/include。 编译过程中常见的动态库依赖：-lpq、-lpq_ce、-lpthread。若开发过程中需要使用libpq通信库，则需要连接-lpq和-lpq_ce。若开发过程中需要使用多线程连接，则需要连接-lpthread。 父主题： 基于ecpg开发

gs_logicalstandby_skip_err(stmt text, dbname text, schema text, object text, dump text) 描述：配置逻辑回放可跳过报错语句所在事务的规则。仅管理员用户在容灾备数据库主机上可以执行，用于处理逻辑回放阻塞问题。多租场景下，该函数在PDB内部禁用。 对于不同规则，即stmt、dbname、schema、object至少有一项与已配置规则不同，调用该函数可用于增加新规则配置。 对于相同规则，即stmt、dbname、schema、object均与某已配置规则相同，调用该函数可用于更新dump值。 参数说明： stmt 跳过回放的语句类型。 取值范围：字符串，支持类型参考表 跳过事务支持的语句类型(一级/二级)说明。 dbname 跳过回放操作所在的数据库名称。 取值范围：字符串，与CREATE DATABASE中database_name取值范围保持一致。 schema 跳过回放操作所在的模式名称。 取值范围：字符串，与CREATE SCHEMA中schema_name取值范围保持一致。 object 跳过回放操作具体的对象名称（目前仅支持数据库表名）。 取值范围：字符串。 dump 记录事务详细信息方式。 取值范围：字符串，支持类型如下： all：记录整个事务详细信息。 no：不记录事务详细信息。 skip：记录事务跳过变更的详细信息。 该参数可缺省，缺省值为skip。 返回值类型：boolean，默认值为true。 示例： 设置规则：跳过systest数据库、public视图、t1数据表的dml执行出错语句，dump类型为all。 gaussdb=# SELECT gs_logicalstandby_skip_err('dml', 'systest', 'public', 't1', 'all'); gs_logicalstandby_skip_err ---------------------------- t (1 row) 设置规则：跳过systest数据库、schema_test视图、t2数据表的insert执行出错语句，dump缺省。 gaussdb=# SELECT gs_logicalstandby_skip_err('insert', 'systest', 'schema_test', 't2'); gs_logicalstandby_skip_err ---------------------------- t (1 row)

gs_logicalstandby_unskip_err(stmt text, dbname text, schema text, object text) 描述：取消逻辑回放可跳过报错语句所在事务的规则。仅管理员用户在容灾备数据库主机上可以执行，用于取消逻辑回放可跳过规则。多租场景下，该函数在PDB内部禁用。 参数说明： stmt 跳过回放的语句类型。 取值范围：字符串，支持类型请参见表 跳过事务支持的语句类型(一级/二级)说明。 dbname 跳过回放操作所在的数据库名称。 取值范围：字符串，与CREATE DATABASE中database_name取值范围保持一致。 schema 跳过回放操作所在的模式名称。 取值范围：字符串，与CREATE SCHEMA中schema_name取值范围保持一致。 object 跳过回放操作具体的对象名称（目前仅支持数据库表名）。 取值范围：字符串。 返回值类型：boolean，默认值为true。 示例： 取消规则：跳过systest数据库、public视图、t1数据表的dml执行出错语句。 gaussdb=# SELECT gs_logicalstandby_unskip_err('dml', 'systest', 'public', 't1'); gs_logicalstandby_unskip_err ------------------------------ t (1 row)

gs_get_sqlapply_playback_progress() 描述：查询逻辑备回放文件中数组信息。查询结果为当前逻辑备回放文件中head位置至tail位置的远端事务信息。head位置之前所有的远端事务均已回放，tail为当前数组中最新需要回放的远端事务，head至tail之前的远端事务则存在已回放或者尚未回放的事务。多租场景下，该函数在PDB内部禁用。 备注：若当前数据库实例不为逻辑备，则查询出的结果不准确，部分字段为默认值。 表5 参数含义 字段名称 说明 xid 当前远端事务的xid。 sequence_number 当前回放的远端事务序号。 remote_csn 当前远端事务的csn。 begin_time 当前远端事务在逻辑备机开始回放的时间。 end_time 当前远端事务在逻辑备机结束回放的时间。 status 远端事务在逻辑备机是否已经回放完毕，t代表回放完毕，f代表尚未回放 示例： gaussdb=# SELECT * FROM gs_get_sqlapply_playback_progress(); xid | sequence_number | remote_csn | begin_time | end_time | status --------+-----------------+------------+-------------------------------+-------------------------------+-------- 254203 | 215 | 192108 | 2024-06-17 11:25:36.72872+08 | 2024-06-17 11:25:36.728941+08 | t 254204 | 216 | 192109 | 2024-06-17 11:25:36.771637+08 | 2024-06-17 11:25:36.771723+08 | t 254205 | 217 | 192110 | 2024-06-17 11:25:36.771663+08 | 2024-06-17 11:25:36.771854+08 | t 254206 | 218 | 192111 | 2024-06-17 11:25:36.771777+08 | 2024-06-17 11:25:36.771977+08 | t 254207 | 219 | 192112 | 2024-06-17 11:25:36.771902+08 | 2024-06-17 11:25:36.772105+08 | t (5 rows)

gs_change_replication_slot_plugin('slot_name', 'plugin_name') 描述：修改逻辑复制槽插件类型。多租场景下，该函数在PDB内部禁用。 参数说明： slot_name 流复制槽名称。 取值范围：字符串，仅支持小写字母、数字以及“_”，“?”，“-”，“.”字符，且不支持“.”或“..”单独作为复制槽名称。 plugin_name 插件名称。 取值范围：字符串，当前支持mppdb_decoding、sql_decoding、parallel_binary_decoding、parallel_json_decoding、parallel_text_decoding。 返回值类型：boolean，默认值为true。 示例： 查询当前复制槽信息： gaussdb=# SELECT * FROM pg_get_replication_slots(); slot_name | plugin | slot_type | datoid | active | xmin | catalog_xmin | restart_lsn | dummy_standby | confirmed_flush | confirmed_csn | dictionary_csn_min | slot_dictionary_type -----------+--------------------------+-----------+--------+--------+------+--------------+-------------+---------------+-----------------+---------------+--------------------+---------------------- slot1 | parallel_json_decoding | logical | 12834 | f | | | 0/125A15E0 | f | 0/125E84D0 | | 7787 | dictionary table slot2 | parallel_binary_decoding | logical | 12834 | f | | | 0/E9C71B0 | f | 0/E9CA638 | | 3860 | dictionary table slot3 | parallel_text_decoding | logical | 12834 | f | | | 0/E9D96D0 | f | 0/EEE6508 | | 3867 | dictionary table slot4 | mppdb_decoding | logical | 12834 | f | | | 0/E9AFC38 | f | 0/EEE6508 | | 3853 | dictionary table (4 rows) 修改复制槽类型： gaussdb=# SELECT * FROM gs_change_replication_slot_plugin('slot1', 'mppdb_decoding'); gs_change_replication_slot_plugin ----------------------------------- t (1 row) 再次查询复制槽信息： gaussdb=# SELECT * FROM pg_get_replication_slots(); slot_name | plugin | slot_type | datoid | active | xmin | catalog_xmin | restart_lsn | dummy_standby | confirmed_flush | confirmed_csn | dictionary_csn_min | slot_dictionary_type -----------+--------------------------+-----------+--------+--------+------+--------------+-------------+---------------+-----------------+---------------+--------------------+---------------------- slot1 | mppdb_decoding | logical | 12834 | f | | | 0/125A15E0 | f | 0/125E84D0 | | 7787 | dictionary table slot2 | parallel_binary_decoding | logical | 12834 | f | | | 0/E9C71B0 | f | 0/E9CA638 | | 3860 | dictionary table slot3 | parallel_text_decoding | logical | 12834 | f | | | 0/E9D96D0 | f | 0/EEE6508 | | 3867 | dictionary table slot4 | mppdb_decoding | logical | 12834 | f | | | 0/E9AFC38 | f | 0/EEE6508 | | 3853 | dictionary table (4 rows)

gs_logicalstandby_skip(stmt text, dbname text, schema text, object text, dump text) 描述：配置逻辑回放可跳过对象的规则。仅管理员用户在容灾备数据库主机上可以执行，用于处理逻辑回放阻塞问题。多租场景下，该函数在PDB内部禁用。 对于不同规则，即stmt、dbname、schema、object至少有一项与已配置规则不同，调用该函数可用于增加新规则配置。 对于相同规则，即stmt、dbname、schema、object均与某已配置规则相同，调用该函数可用于更新dump值。 参数说明： stmt 跳过回放的语句类型。 取值范围：字符串，支持类型参考表6： 表6 跳过事务支持的语句类型(一级/二级) 一级语句类型 二级语句类型 dml insert/update/delete dbname 跳过回放操作所在的数据库名称。 取值范围：字符串，与CREATE DATABASE中database_name取值范围保持一致。 schema 跳过回放操作所在的模式名称。 取值范围：字符串，与CREATE SCHEMA中schema_name取值范围保持一致。 object 跳过回放操作具体的对象名称（目前仅支持数据库表名）。 取值范围：字符串。 dump 记录事务详细信息方式。 取值范围：字符串，支持类型如下：all-记录整个事务详细信息 no-不记录事务详细信息 skip-记录事务跳过变更的详细信息。 该参数可缺省，缺省值为skip。 返回值类型：boolean，默认值为true。 示例： 设置规则：跳过systest数据库、public视图、t1数据表的全部dml语句，dump类型为all。 gaussdb=# SELECT gs_logicalstandby_skip('dml', 'systest', 'public', 't1', 'all'); gs_logicalstandby_skip ------------------------ t (1 row) 设置规则：跳过systest数据库、schema_test视图、t2数据表的insert语句，dump缺省。 gaussdb=# SELECT gs_logicalstandby_skip('insert', 'systest', 'schema_test', 't2'); gs_logicalstandby_skip ------------------------ t (1 row)

gs_logicalstandby_unskip(stmt text, dbname text, schema text, object text) 描述：取消逻辑回放可跳过对象的规则。仅管理员用户在容灾备数据库主机上可以执行，用于取消逻辑回放可跳过规则。多租场景下，该函数在PDB内部禁用。 参数说明： stmt 跳过回放的语句类型。 取值范围：字符串，支持类型参考表 跳过事务支持的语句类型(一级/二级)说明。 dbname 跳过回放操作所在的数据库名称。 取值范围：字符串，与CREATE DATABASE中database_name取值范围保持一致。 schema 跳过回放操作所在的模式名称。 取值范围：字符串，与CREATE SCHEMA中schema_name取值范围保持一致。 object 跳过回放操作具体的对象名称（目前仅支持数据库表名）。 取值范围：字符串。 返回值类型：boolean，默认值为true。 示例： 取消规则：跳过systest数据库、public视图、t1数据表的全部dml语句。 gaussdb=# SELECT gs_logicalstandby_unskip('dml', 'systest', 'public', 't1'); gs_logicalstandby_unskip -------------------------- t (1 row)

gs_logicalstandby_unskip_txn(csn int64, xid int64) 描述：取消逻辑回放可跳过事务的规则。仅管理员用户在容灾备数据库主机上可以执行，用于取消逻辑回放可跳过规则。多租场景下，该函数在PDB内部禁用。 参数说明： csn 跳过事务的提交序号。 取值范围：1~2^63-1间的64位整数。 xid 跳过事务标识。 取值范围：3~2^63-1间的64位整数。 返回值类型：boolean，默认值为true。 示例： 取消规则：跳过事务提交序号123456、事务标识345678。 gaussdb=# SELECT gs_logicalstandby_unskip_txn(123456, 345678); gs_logicalstandby_unskip_txn ------------------------------ t (1 row)

gs_logicalstandby_skip_txn(csn int64, xid int64, dump text) 描述：配置逻辑回放可跳过事务的规则。仅管理员用户在容灾备数据库主机上可以执行，用于处理逻辑回放阻塞问题。多租场景下，该函数在PDB内部禁用。 对于不同规则，即csn、xid至少有一项与已配置规则不同，调用该函数可用于增加新规则配置。 对于相同规则，即csn、xid均与某已配置规则相同，调用该函数可用于更新dump值。 参数说明： csn 跳过事务的提交序号。 取值范围：1~2^63-1间的64位整数。 xid 跳过事务标识。 取值范围：3~2^63-1间的64位整数。 dump 记录事务详细信息方式。 取值范围：字符串，支持类型如下：all-记录整个事务详细信息 no-不记录事务详细信息 skip-记录事务跳过变更的详细信息。 该参数可缺省，缺省值为skip。 该系统函数dump值的'all'与'skip'配置等价。 返回值类型：boolean，默认值为true。 示例： 设置规则：跳过事务提交序号123456、事务标识345678、dump类型为all。 gaussdb=# SELECT gs_logicalstandby_skip_txn(123456, 345678, 'all'); gs_logicalstandby_skip_txn ---------------------------- t (1 row) 设置规则：跳过事务提交序号123456、事务标识345678、dump缺省。 gaussdb=# SELECT gs_logicalstandby_skip_txn(123456, 345678); gs_logicalstandby_skip_txn ---------------------------- t (1 row)

gs_get_parallel_decode_thread_info() 描述：在并行解码所在的DN执行，返回当前DN上并行解码的线程信息。多租场景下，non-PDB调用该函数时返回全部信息，PDB调用该函数时返回本PDB的数据。 返回值类型：int64、text、text、int 示例： gaussdb=# SELECT * FROM gs_get_parallel_decode_thread_info(); thread_id | slot_name | thread_type | seq_number -----------------+-----------+-------------+------------ 140335364699904 | slot1 | sender | 1 140335214098176 | slot1 | reader | 1 140335325312768 | slot1 | decoder | 1 140335291750144 | slot1 | decoder | 2 140335274968832 | slot1 | decoder | 3 140335258187520 | slot1 | decoder | 4 140335165404928 | slot2 | sender | 1 140335022864128 | slot2 | reader | 1 140335129818880 | slot2 | decoder | 1 140335113037568 | slot2 | decoder | 2 (10 rows) 备注：返回值thread_id代表线程id，slot_name代表复制槽名，thread_type表示线程种类（共三种，sender代表发送线程、reader代表读取线程、decoder代表解码线程），seq_number代表每个线程在当前复制槽中同种线程的序号。其中sender和reader在每个并行解码连接中均只有一个，因此序号均为1，decoder的序号从1排列到当前复制槽解码并行度。

pg_replication_origin_advance (node_name, lsn) 描述： 将给定节点的复制进度设置为给定的位置。这主要用于设置初始位置，或在配置更改或类似的变更后设置新位置。 注意：这个函数的使用不当可能会导致不一致的复制数据。 备注：调用该函数的用户需要具有SYSADMIN权限。 参数说明： node_name 已有复制源名称。 取值范围：字符串，不支持除字母、数字以及“_”，“?”，“-”，“.”以外的字符。 lsn 复制源回放位置。 取值范围：LSN

gs_get_inter_cluster_version_info() 描述：查询主备数据库的版本号、逻辑解码组件的版本以及复制类型（逻辑复制或者物理复制）。无入参。双集群大版本滚动升级内部使用功能，不建议用户使用。多租场景下，该函数在PDB内部禁用。返回5列，第一列remote_working_version为远端内核版本号；第二列remote_logical_decoding_version为远端解码组件版本号；第三列local_working_version为当前节点内核版本号；第四列local_logical_decoding_version为当前节点解码组件版本号；第五列replication_type为复制类型（“logic”为逻辑复制，“physic”为物理复制）。 返回值类型：int、text、int、text、text

pg_replication_origin_session_setup (node_name) 描述：将当前会话标记为从给定的原点回放，从而允许跟踪回放进度。只能在当前没有选择原点时使用。使用pg_replication_origin_session_reset 命令来撤销。 备注：调用该函数的用户需要具有SYSADMIN权限。 参数说明： node_name 复制源名称。 取值范围：字符串，不支持除字母、数字以及“_”，“?”，“-”，“.”以外的字符。

pg_replication_origin_xact_setup (origin_lsn, origin_timestamp) 描述：将当前事务标记为重放在给定LSN和时间戳上提交的事务。只能在使用pg_replication_origin_session_setup选择复制源时调用。 备注：调用该函数的用户需要具有SYSADMIN权限。 参数说明： origin_lsn 复制源回放位置。 取值范围：LSN origin_timestamp 事务提交时间。 取值范围：timestamp with time zone