文档数据库 MongoDB 版提供了手动切换主节点功能，您可以根据业务部署需要将从节点切换为主节点，满足业务就近连接需求。本文介绍切换主节点的相关操作步骤。

前提条件

• 实例状态需为运行中。关于实例状态的更多详情，请参见实例状态说明。
• 需要进行手动切换节点，必须是如下任一实例或组件类型中的从节点：
  • 副本集实例
  • 分片集群实例中 Shard 分片
  • 分片集群实例中 ConfigServer 组件

注意事项

• 手动切换主节点过程（一般需要 30~60 秒）中，实例可能会出现 1~2 次连接闪断，请谨慎操作。建议在业务低峰期执行切换操作，并确保应用具备自动重连机制。
• 手动切换主节点仅改变节点的角色，不会改变节点所在的可用区和节点 ID。

操作步骤

1. 登录 MongoDB 控制台。
2. 在顶部菜单栏的左上角，选择实例所属的项目和地域。
3. 根据实例类型，在左侧导航栏中选择副本集实例列表或分片集实例列表。
4. 在目标实例类型列表页，单击目标实例名称。

5. 在实例信息页签下的节点信息区域，根据实例或组件类型完成对应切换操作。

   注意

   手动切换主节点过程（一般需要 30~60 秒）中，实例可能会出现 1~2 次连接闪断，请谨慎操作。建议在业务低峰期执行切换操作，并确保应用具备自动重连机制。

   实例或组件类型		具体操作
   副本集实例		在节点信息区域，找到目标从节点。 在从节点右侧操作栏中，单击切换主节点。 在弹出的对话框中确认切换操作的影响，单击确定。
   分片集群实例	Shard	在节点信息区域，单击 Shards 页签。 从 Shards 页签的分片列表中找到目标 Shard。 单击目标 Shard 最左侧的图标，在下方的节点列表中找到目标从节点。 在从节点右侧操作栏中，单击切换主节点。 在弹出的对话框中确认切换操作的影响，单击确定。
   	ConfigServer	在节点信息区域，单击 ConfigServers 页签。 单击 ConfigServers 列表最左侧的图标，在下方的节点列表中找到目标从节点。 在从节点右侧操作栏中，单击切换主节点。 在弹出的对话框中确认切换操作的影响，单击确定。

相关 API