云数据库 GAUSSDB-逻辑复制:sqlapply_logical_decode_options

时间:2025-06-03 09:36:09

sqlapply_logical_decode_options

参数说明:逻辑回放的解码任务启动选项。选项包括:parallel-decode-num,parallel-queue-size,max-txn-in-memory,max-reorderbuffer-in-memory,exclude-users,skip-generated-columns,enable-ddl-decoding,only-local,decode-sequence。

参数类型:字符串

参数单位:无

取值范围

  • parallel-decode-num

    指定并行解码的Decoder线程数量。

    取值范围:1 ~ 20的整型,默认值为2。

  • parallel-queue-size

    并行逻辑解码线程间进行交互的队列长度。

    取值范围:2 ~ 1024的整型,且只能为2的幂次方,默认值为128。

  • max-txn-in-memory

    内存管控参数,单位为MB,单个事务占用内存大于该值即进行落盘。

    取值范围:0 ~ 100的整型,默认值为0,即不开启此种管控。

  • max-reorderbuffer-in-memory

    内存管控参数,单位为GB,拼接-发送线程中正在拼接的事务总内存(包含缓存)大于该值则对当前解码事务进行落盘。

    取值范围:0 ~ 100的整型,默认值为0,即不开启此种管控。

  • exclude-users

    黑名单用户的名字参数。

    取值范围:指定黑名单用户的名字,多个名字通过','分隔。

  • skip-generated-columns

    逻辑解码控制参数,用于跳过存储生成列的输出。对UPDATE和DELETE的旧元组无效,相应元组始终会输出存储生成列。

    取值范围:boolean型,默认值为false。

    • false:设为false时,输出存储生成列的解码结果。
    • true:值为true时,不输出存储生成列的解码结果。

    虚拟生成列不受此参数控制,DML的解码结果始终不会输出虚拟生成列。

  • enable-ddl-decoding

    逻辑解码控制参数,用于控制是否开启DDL语句的逻辑解码。

    取值范围:bool型,默认值为true。
    • false:设为false时,不开启DDL语句的逻辑解码。
    • true:设为true时,开启DDL语句的逻辑解码。
  • only-local

    是否仅解码本地日志。

    取值范围:Boolean,默认值为true。

    • false:设为false时,解码非本地日志和本地日志。
    • true:设为true时,仅解码本地日志。
  • decode-sequence

    逻辑解码控制参数,用来指定是否输出sequence值的变更日志的解码结果。

    取值范围:boolean型,默认值为true。

    • false:设为false时,不输出sequence值的变更日志的解码结果。
    • true:输出sequence值的变更日志的解码结果。

默认值:默认设置enable-ddl-decoding=true和decode-sequence=true。

设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。该参数SIGHUP生效并不会影响已经启动的逻辑解码流程。

设置建议:建议根据业务需求进行设置。

设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。

support.huaweicloud.com/centralized-devg-v8-gaussdb/gaussdb-40-0521.html