文档中心

文档数据库 MongoDB 版

实例管理

切换主节点

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

前提条件

注意事项

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

操作步骤

注意

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

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

API	描述
SwitchDBMaster	调用 SwitchDBMaster 接口手动切换指定实例的主从节点角色。