文档中心

云数据库 veDB MySQL 版

实例管理

切换主节点

云数据库 veDB MySQL 版提供主备切换功能。当检测到实例发生故障时，系统会立即触发主备切换，及时恢复实例正常运行，保障实例的高可用。您也可以手动切换主节点，本文介绍手动切换主节点的操作步骤。

前提条件

已创建实例，实例处于运行中状态。

当前没有备份任务。

故障切换机制

在系统发生故障时，实例的主节点和只读节点之间会自动进行故障切换。veDB MySQL 支持为每个节点设置切主优先级，该优先级能够决定在发生故障进行主节点切换时，每个节点被选举为主节点的概率大小。当多个节点优先级不同时，将按照设定的优先级顺序进行切换；当多个节点优先级相同时，则优先选择 LSN 大的节点。

切换主节点按以下步骤进行：

系统找出当前所有具备选举资格的只读节点。

选择优先级最高的一个或多个只读节点。

若切换第一个节点失败（如网络问题、复制状态异常等），则会尝试切换下一个节点，直至切换成功。

切换时间和影响

切换主节点在正常情况下耗时约 30 秒，在此期间数据库可能会发生 1~2 次闪断，请确保您的应用程序具备自动重连机制，以降低数据库连接闪断对业务的影响。

切换前请检查实例是否存在执行中的 Online DDL 任务，切换主节点操作会导致该任务中断，请谨慎操作。详情信息请参见查看工单。

切换主节点时，自定义终端关联的节点会根据切换到的只读节点发生变化，详情如下所示：

终端类型	自定义只读终端	自定义读写终端
切换影响	若切换到的只读节点未关联当前自定义只读终端，则自定义只读终端关联的节点不变。若切换到的只读节点关联了当前自定义只读终端，在切换主节点后，自定义只读终端会取消与该节点的关联，并自动关联原主节点。注意若存在自定义只读终端仅关联了一个只读节点，此时因主节点故障导致主备切换，该只读节点成为新的主节点，切换后，原主节点依旧故障，此时流量不转发，该只读终端地址在原主节点恢复之前不可用。	若切换到的只读节点关联了当前自定义读写终端，则自定义读写终端关联的节点不变。若切换到的只读节点未关联当前自定义读写终端，在切换主节点后，当前自定义读写终端会关联新切换的主节点，原主节点会变为只读节点，并取消与自定义读写终端的关联。
切换示例	某实例的 4 个节点分别为 node0（主）、node1、node2 和 node3。存在自定义只读终端，关联了节点 node1、node2，切换主节点时，情况如下：切换 node1 为主节点，该只读终端关联的节点为 node0、node2。切换 node3 为主节点，不影响该终端，关联的节点依旧为 node1、node2。	某实例的 4 个节点分别为 node0（主）、node1、node2 和 node3。存在自定义读写终端，关联了节点 node0（主）、node1，切换主节点时，情况如下：切换 node1 为主节点，该读写终端关联的节点依旧为 node1（主）、node0。切换 node2 为主节点，该读写终端关联的节点为 node2（主）、node1。

手动切换主节点

登录云数据库 veDB MySQL 版控制台。

在顶部菜单栏选择实例所属的项目和地域。

在实例列表页面，单击目标实例名称，进入实例信息页。

单击连接管理页签，将鼠标指向实例拓扑区域的目标只读节点，在弹出的操作框中单击切换主节点。

在弹出的确认对话框中，确认切换主节点的影响范围，单击确定。

设置节点切主优先级

登录云数据库 veDB MySQL 版控制台。

在顶部菜单栏选择实例所属的项目和地域。

在实例列表页面，单击目标实例名称，进入实例信息页。

单击连接管理页签，将鼠标指向实例拓扑区域的目标节点，在弹出的操作框中单击修改。

在弹出的对话框中输入优先级，取值范围为 0~15。数值越大，优先级越高。

说明

实例创建成功后，每个节点的优先级默认为 1，新增只读节点的优先级也同样默认为 1。

支持动态修改每个节点的切主优先级（包括当前的主节点优先级），修改优先级不会触发切换。

单击确定。

API	描述
ModifyDBNodeConfig	调用 ModifyDBNodeConfig 接口设置指定节点在主备切换时被选为主节点的优先级。