本文介绍如何通过控制台升级灾备/只读实例为主实例。
操作场景
计划性维护：在主实例需要进行升级、重启等维护操作前，将灾备实例切换为主实例，确保业务连续性。
地域迁移：将业务从当前地域迁移到灾备实例所在的地域。
故障恢复：当主实例发生故障无法正常工作时，快速将灾备实例切换为主实例，恢复业务运行。
注意事项
升级主实例过程中会有秒级的连接闪断，建议在业务低峰期执行切换操作，同时应用程序应具备自动重连机制，避免报错。
切换期间，相关实例的状态会变为调整配置中，请避免同时执行其他变更操作。
若业务强依赖原连接地址，升级后请及时核对实例连接地址、账号权限和访问策略，并同步更新应用侧配置。
工作原理
TDSQL Boundless 支持以下两种切换类型：
切换类型 | 说明 | 适用场景 | 特点 |
常规切换 | 切换时将会把主实例设为只读，切换完成后开放新主实例的读写。 切换时会断开原主实例向原备实例的数据同步链路，切换完成后，会建立起新主实例向新备实例的反向数据同步链路。 切换后，请使用新主实例的 IP 地址来接入数据库服务。 | 计划性维护、地域迁移 | 数据强一致，无数据丢失风险，业务有秒级闪断。 |
强制切换 | 切换时，备实例会断开与主实例的连接，成为独立实例，并开放读写。 切换时，备实例不等待与主实例的数据同步，因此可能存在数据丢失风险。 切换后，请使用新主实例的 IP 地址来接入数据库服务。 注意： 主实例处于正常运行状态时，不建议使用强制切换功能。 | 主实例故障无法恢复 | 恢复速度最快，但存在数据丢失风险。 |
操作步骤
1. 登录 TDSQL Boundless 控制台。
2. 在左侧导航栏选择实例列表，单击目标灾备实例的实例 ID，进入实例详情页。
3. 在实例详情页的右上角操作区域，单击与主实例切换。
4. 在弹出窗中，选择是否强制切换并设置参数。
参数 | 说明 |
是否强制切换 | 关闭 (默认)：执行常规切换，安全无数据丢失。 开启：执行强制切换，用于紧急容灾，有数据丢失风险。 |
是否检查延迟 | 此参数仅在执行常规切换时生效。 开启 (默认)：系统会检查主备同步延迟，只有当延迟小于下方设定的阈值时，才允许执行切换。 关闭：系统不检查同步延迟，立即开始切换流程。 |
允许切换延迟（s） | 当是否检查延迟开启时，您需要设置一个允许的最大同步延迟。如果实际延迟超过此值，切换将失败。 取值范围：5 - 600秒 |
5. 确认信息无误后，单击确定。
两种切换类型完成后，结果如下：
常规切换：原灾备实例变为新的主实例，原主实例变为新的灾备实例，双方角色互换，灾备同步关系继续保持。切换后，请使用新主实例的 IP 地址来接入数据库服务。
强制切换：灾备实例变为独立的主实例，原灾备关系解除。新的主实例使用原灾备实例的连接地址，应用程序需要更新连接配置。
切换后验证
1. 检查实例状态。
1.1 返回实例列表页面，确认相关实例状态已恢复为运行中。
1.2 检查实例角色是否已按预期切换。
2. 测试业务连接。
2.1 使用新的主实例连接地址测试业务连接。
2.2 执行简单的数据库操作，验证读写功能正常。
2.3 检查应用程序日志，确认无连接错误。
3. 监控业务运行。
监控业务关键指标15 - 30分钟，确认业务运行平稳，无异常波动。如有问题，及时联系腾讯云技术支持。
