PingKai Logo下载

ADMIN SWITCHOVER

ADMIN SWITCHOVER 用于物理复制主备集群的计划内切换(Switchover)。支持以下两条语句:

所需权限

执行 SWITCHOVER 相关语句需要 SUPER 权限。

限制

  • 仅支持相邻 primary/standby 之间的切换。
  • 切换前复制链路不能处于暂停状态。
  • 建议先确认目标集群在 INFORMATION_SCHEMA.LR_CLUSTER_STATUS_GLOBAL 中的 SWITCHOVER_READY = 'YES'

ADMIN SWITCHOVER AS PRIMARY

ADMIN SWITCHOVER AS PRIMARY 用于从 standby 侧发起计划内主备切换。执行该语句后,当前 standby 集群会被提升为 primary,系统会自动与原 primary 协调完成角色切换。切换过程中 TiDB 节点会自动重启。

该语句必须在当前 standby 集群上执行。

语法图

ADMIN SWITCHOVER AS PRIMARY;

示例

ADMIN SWITCHOVER AS PRIMARY;

MySQL 兼容性

ADMIN SWITCHOVER AS PRIMARY 语句是 TiDB 对 MySQL 语法的扩展。


ADMIN SWITCHOVER PRIMARY TO

ADMIN SWITCHOVER PRIMARY TO 用于指定将要提升为 primarystandby 集群并发起计划内主备切换。执行该语句后,系统会自动完成 primary 禁止写入、追平数据和 primary/standby 角色切换。切换过程中 TiDB 节点会自动重启。

语法图

ADMIN SWITCHOVER PRIMARY TO <new_primary_cluster_id>;

参数说明

参数说明
new_primary_cluster_id将要成为新 primary 的集群 ID

示例

ADMIN SWITCHOVER PRIMARY TO 2048;

MySQL 兼容性

ADMIN SWITCHOVER PRIMARY TO 语句是 TiDB 对 MySQL 语法的扩展。

另请参阅