PingKai Logo下载

ADMIN ALTER LOG REPLICATION

ADMIN ALTER LOG REPLICATION 用于修改已创建的物理复制链路的保护模式、降级超时或切换 source 集群。该语句可以在 primary 集群以及复制链路的直接上游/下游集群执行。

所需权限

执行该语句需要 SUPER 权限。

语法图

-- 修改保护模式
ADMIN ALTER LOG REPLICATION <name>
    PROTECTION_MODE = MAXIMUM_PERFORMANCE | MAXIMUM_PROTECTION | MAXIMUM_AVAILABILITY
    [DEGRADE_TIMEOUT = '<duration>'];

-- 切换 source
ADMIN ALTER LOG REPLICATION <name> CHANGE SOURCE TO <new_source_cluster_id>;

参数说明

参数说明
name复制链路名称
PROTECTION_MODE保护模式,可选值:MAXIMUM_PERFORMANCEMAXIMUM_PROTECTIONMAXIMUM_AVAILABILITY
DEGRADE_TIMEOUT降级超时时长,仅在 PROTECTION_MODE = MAXIMUM_AVAILABILITY 时生效。设置 MAXIMUM_AVAILABILITY 时必须同时指定

当从 MAXIMUM_PERFORMANCE 切换到同步模式时,系统会等待 checkpoint lag 低于 tidb_alter_sync_max_lag_seconds(默认 10 秒)后再执行切换。

示例

切换到最大保护模式:

ADMIN ALTER LOG REPLICATION dr_east
    PROTECTION_MODE = MAXIMUM_PROTECTION;

切换到最大可用模式:

ADMIN ALTER LOG REPLICATION dr_east
    PROTECTION_MODE = MAXIMUM_AVAILABILITY
    DEGRADE_TIMEOUT = '30s';

切换 source

ADMIN ALTER LOG REPLICATION dr_east CHANGE SOURCE TO 2048;

MySQL 兼容性

ADMIN ALTER LOG REPLICATION 语句是 TiDB 对 MySQL 语法的扩展。

另请参阅