文档数据库 MongoDB 版支持节点角色切换功能，您可以根据业务需要切换主、从、隐藏节点的角色，实现业务就近访问。
前提条件
- 实例架构为副本集实例。关于产品架构的更多说明，请参见产品架构。
- 实例状态为运行中。关于实例状态的更多说明，请参见实例状态。
- 实例未申请公网地址。若实例已申请公网地址，需先释放公网地址后再执行角色切换操作。具体操作步骤，请参见释放公网地址。
节点角色切换场景
说明
- 文档数据库 MongoDB 版当前支持 4 种类型的节点：主节点、从节点、隐藏节点和只读节点。关于不同类型节点的详情，请参见不同类型的节点对比。
- 关于表格中的标识，说明如下：
- ✔️ ：表示支持从原节点角色切换为目标节点角色。
- ❌ ：表示不支持从原节点角色切换为目标节点角色。
| 原节点或目标节点角色 | 主节点 | 从节点 | 隐藏节点 | 只读节点 |
|---|
| 主节点 | 不涉及 | ✔️ | ✔️ | ❌ |
| 从节点 | ✔️ | 不涉及 | ✔️ | ❌ |
| 隐藏节点 | ✔️ | ✔️ | 不涉及 | ❌ |
| 只读节点 | ❌ | ❌ | ❌ | 不涉及 |
注意事项
- 手动切换节点角色过程（一般需要 30~60 秒）中，实例可能会出现 1~2 次连接闪断，请谨慎操作。建议在业务低峰期执行切换操作，并确保应用具备自动重连机制。
- 节点角色切换操作仅会变更节点的角色，不会改变节点所在的可用区和节点 ID。
操作步骤
- 登录 MongoDB 控制台。
- 在顶部菜单栏的左上角，选择实例所属的项目和地域。
- 根据实例类型，在左侧导航栏中选择副本集实例列表。
- 在实例列表页，单击目标实例名称。
- 在实例信息页签下的节点信息区域，单击角色切换。
- 在弹出的角色切换控制面板中，分别从原角色和目标角色下拉框中，选择对应节点。
注意
- 手动切换节点角色过程（一般需要 30~60 秒）中，实例可能会出现 1~2 次连接闪断，请谨慎操作。建议在业务低峰期执行切换操作，并确保应用具备自动重连机制。
- 节点的原角色和目标角色必须不同。
- 在页面右下角，单击确定。