华为云用户手册

enable_lock_account 参数说明：当将failed_login_attempts设置为0时，自动锁定功能将被关闭。在此设置下，系统无法记录账号的登录失败次数。若使用enable_lock_account关闭自动锁定功能，账号使用错误密码连续登录失败达到参数failed_login_attempts所设定的值后，将不会自动锁定账号。此时，系统将通过上报告警来保障账号安全。该功能详情请参考《告警参考》中“连续登录失败告警”章节。管理员手动锁定不受参数控制。 参数类型：布尔型 参数单位：无 取值范围： on：表示账号使用错误密码连续登录失败达到参数failed_login_attempts所设定的值后，自动锁定账号。 off：表示账号使用错误密码连续登录失败达到参数failed_login_attempts所设定的值后，不自动锁定账号。 默认值：on 设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。 设置建议：从安全性考虑，如未启用告警功能，请勿关闭自动锁定账号功能。 设置不当的风险与影响：设置为off会降低账号安全性。

password_max_length 参数说明：该参数决定账户密码的最大长度，仅sysadmin用户可以访问。 参数类型：整型 参数单位：无 取值范围：6 ~ 999 默认值：32 设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。 设置建议：根据实际业务需求配置，推荐使用默认值。 设置不当的风险与影响：设置长度小于password_min_length会导致账户无法正常创建。

password_encryption_type 参数说明：该参数决定采用何种加密方式对用户密码进行加密存储。修改此参数的配置不会自动触发已有用户密码加密方式的修改，只会对新创建用户的密码或已有用户修改的密码采用新的加密方式进行加密。 参数类型：整型 参数单位：无 取值范围：0、1、2、3 0：表示采用md5方式对密码加密。 1：表示采用sha256和md5两种方式分别对密码加密。 2：表示采用sha256方式对密码加密。 3：表示采用sm3方式对密码加密。 默认值：2 设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。 设置建议：推荐使用默认值。 设置不当的风险与影响：MD5加密算法安全性低，不建议使用，设置为0或1时存在安全风险。

password_min_length 参数说明：该参数决定账户密码的最小长度，仅sysadmin用户可以访问。 参数类型：整型 参数单位：无 取值范围：6 ~ 999 默认值：8 设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。 设置建议：根据实际业务需求配置，推荐使用默认值。 设置不当的风险与影响：设置长度超过password_max_length会导致账户无法正常创建。

password_min_uppercase 参数说明：该参数决定账户密码中至少需要包含的大写字母的个数，仅sysadmin用户可以访问。 参数类型：整型 参数单位：无 取值范围：0 ~ 999 0：表示没有限制。 1 ~ 999：表示创建账户所指定的密码中至少需要包含的大写字母的个数。 默认值：0 设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。 设置建议：根据实际业务需求配置，推荐使用默认值。 设置不当的风险与影响：设置长度超过password_max_length会导致账户无法正常创建。

password_reuse_time 参数说明：该参数控制的是，在使用ALTER USER或者ALTER ROLE修改用户密码时，是否对新密码进行可重用天数检查。 修改密码时会检查配置参数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时，表示不对密码重用进行限制。 参数类型：浮点型 参数单位：d（天） 取值范围：0 ~ 3650 0表示不检查密码可重用的天数。 正数表示新密码不能为该值指定的天数内使用过的密码。 默认值：0 设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。 设置建议：参数值设置越大越安全，但是在使用过程中会带来不便，依据业务安全诉求设定。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

password_lock_time 参数说明：该参数指定账户被锁定后自动解锁所需的时间。 只有当password_lock_time和failed_login_attempts的取值都为正数时，账户锁定和解锁功能才能生效。 参数类型：浮点型 参数单位：d（天） 取值范围：0 ~ 365。取值的整数部分表示天数，小数部分可以换算成时、分、秒，如：password_lock_time=1.5，表示1天零12小时。 0表示密码验证失败时，自动锁定功能不生效。 正数表示账户被锁定后，当锁定时间超过password_lock_time设定的值时，账户将会被自行解锁。 默认值：1 设置方式：该参数属于SIGHUP类型参数，请参见表1中对应设置方法进行设置。取值如果要带单位，必须为d。 设置建议：设置为默认值。自动解锁时间不宜设置过长，需要同failed_login_attempts参数设置保持在合理范围内。 设置不当的风险与影响：如果failed_login_attempts参数设置过小，自动解锁时间设置过长，会导致因误输入导致账号长时间无法使用，影响用户正常使用。

password_reuse_max 参数说明：该参数控制的是，在使用ALTER USER或者ALTER ROLE修改用户密码时，是否对新密码进行可重用次数检查，仅sysadmin用户可以访问。 修改密码时会检查配置参数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 ~ 1000 0表示不检查密码可重用次数。 正整数表示新密码不能为该值指定的次数内使用过的密码。 默认值：0 设置方式：该参数属于SIGHUP类型参数，请参见表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中对应设置方法进行设置。 设置建议：从安全性考虑，请勿关闭密码复杂度策略。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

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

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

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

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通信，数据存在泄漏风险。

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通信，数据存在泄漏风险。

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。

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

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

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_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_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_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_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)