缓存数据库 Redis 版支持手动执行主从切换功能，您可以将指定从节点切换为主节点，满足容灾演练或多可用区场景下就近连接的需求。本文介绍如何手动执行主从切换。

前提条件

实例类型为主备实例。单节点实例不支持主从切换功能。关于两种类型实例的功能特性差异详情，请参见功能特性差异。

注意事项

• 正在切换的节点将出现秒级的连接闪断，建议在业务低峰期进行切换操作，并确保应用具备自动重连机制。
• 正在切换的节点会出现短暂的（30 秒内）只读状态，来尽量避免主从切换引起的数据丢失和 DNS 缓存引起的数据双写情况。
• 手动切换主节点后，若实例发生了故障，系统会立即触发故障切换保障实例高可用，此时实例的主节点可能会与您手动切换主节点时选择的主节点不一致。

操作步骤

1. 登录 Redis 控制台。
2. 在顶部菜单栏的左上角，选择实例所属的项目和地域。
3. 在实例列表页，单击目标实例名称。
4. 在实例信息页签下的拓扑架构区域，单击拓扑图右侧的 Server 节点图标。
5. 在下方的 Shard 分片列表中，找到进行节点切换的目标从节点，单击右侧操作栏中的切主。
6. 在弹出的对话框中，确认主从切换影响，以及需要执行切换的节点信息，单击确定。

相关 API