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>;

-- 重命名复制链路
ADMIN ALTER LOG REPLICATION <name> RENAME TO <new_name>;

参数说明

参数说明
name复制链路名称
PROTECTION_MODE保护模式，可选值：MAXIMUM_PERFORMANCE、MAXIMUM_PROTECTION、MAXIMUM_AVAILABILITY
DEGRADE_TIMEOUT降级超时时长，仅在 PROTECTION_MODE = MAXIMUM_AVAILABILITY 时生效。设置 MAXIMUM_AVAILABILITY 时必须同时指定
new_source_cluster_id新 source 集群 ID。CHANGE SOURCE 不能与其他 ALTER 选项组合使用
new_name新的复制链路名称，不能与旧名称相同或与现有链路重名。RENAME 不能与其他 ALTER 选项组合使用

当复制从 ASYNC 切换到 SYNC 时，系统会等待 standby 心跳有效且 checkpoint lag 不超过 PD 配置项 log-replication.sync-switch-max-lag 指定的阈值。默认值为 10s。

示例

切换到最大保护模式：

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;

重命名复制链路：

ADMIN ALTER LOG REPLICATION dr_east RENAME TO dr_west;

MySQL 兼容性

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

另请参阅