文档中心

文档数据库 MongoDB 版

实例管理

切换节点角色

切换节点角色

文档数据库 MongoDB 版支持节点角色切换功能，您可以根据业务需要切换主、从、隐藏节点的角色，实现业务就近访问。

前提条件

仅如下实例或组件类型支持切换节点角色：

副本集实例

分片集群实例中 Shard 分片

分片集群实例中 ConfigServer 组件

关于实例类型的更多说明，请参见产品架构。

实例状态为运行中。关于实例状态的更多说明，请参见实例状态。

节点角色切换场景

说明

文档数据库 MongoDB 版当前支持 4 种类型的节点：主节点、从节点、隐藏节点和只读节点。关于不同类型节点的详情，请参见不同类型的节点对比。

关于表格中的标识，说明如下：

✔️ ：表示支持从原节点角色切换为目标节点角色。

❌ ：表示不支持从原节点角色切换为目标节点角色。

原节点或目标节点角色	主节点	从节点	隐藏节点	只读节点
主节点	不涉及	✔️	✔️	❌
从节点	✔️	不涉及	✔️	❌
隐藏节点	✔️	✔️	不涉及	❌
只读节点	❌	❌	❌	不涉及

注意事项

手动切换节点角色过程（一般需要 30 秒 ~ 60 秒）中，实例可能会出现 1 次 ~ 2 次连接闪断，请谨慎操作。

若实例开启了公网访问，切换过程中公网连接地址会出现短暂的不可用或断连，强烈建议避免在切换过程中通过公网连接地址执行读写操作。

建议在业务低峰期执行切换操作，并确保应用具备自动重连机制。

节点角色切换操作仅会变更节点的角色，不会改变节点所在的可用区和节点 ID。

操作步骤

登录 MongoDB 控制台。

在顶部菜单栏，选择实例所属的项目和地域。

根据实例类型，在左侧导航栏中选择副本集实例列表或分片集实例列表。

在目标实例类型列表页，单击目标实例名称。

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

说明

切换节点角色时，节点的原角色和目标角色必须不同。

实例或组件类型			具体操作
副本集实例			在节点信息区域，单击角色切换。在弹出的面板中，分别从原角色和目标角色下拉框中，选择对应节点。在页面右下角，单击确定。
分片集群实例	Shard	在节点信息区域，单击 Shards 页签。在 Shards 页签下单击角色切换。在弹出的面板中，先从选择 Shard 的下拉框中选择目标分片，然后分别从原角色和目标角色下拉框中，选择对应节点。在页面右下角，单击确定。
分片集群实例		ConfigServer	在节点信息区域，单击 ConfigServers 页签。在 ConfigServers 页签下单击角色切换。在弹出的面板中，分别从原角色和目标角色下拉框中，选择对应节点。在页面右下角，单击确定。

最近更新时间：2026.09.14 16:01:28

这个页面对您有帮助吗？

有用

有用

无用

无用