通过MongoShell连接实例
更新时间:2026-03-04
Mongo Shell 是 MongoDB 官方数据库管理工具,您可以在实例所在的VPC内创建BCC并在其上安装 Mongo Shell 工具,然后通过 Mongo Shell 连接实例。
前提条件
- 为保障鉴权成功,请安装与 MongoDB 实例版本相对应的 Mongo Shell 版本。安装步骤请参见官方文档 Install MongoDB(请根据您的客户端版本在页面左上角选择版本号)。
- 已将客户端的 IP 地址加入到 MongoDB 实例的白名单中,详情请参见 设置白名单。
操作步骤
- 登录 MongoDB 管理控制台。
- 在页面左上角,选择实例所在的地域。
- 在左侧导航栏,访问 副本集实例列表 或 分片集实例列表。
- 找到目标实例,单击 实例名称。
- 在实例 数据库链接信息 中,获取实例或节点的链接地址。
- 在已安装 Mongo Shell 的客户端通过以下方式连接实例。
- 高可用连接方式
使用 ConnectionStringURI 连接数据库,可确保连接的节点始终为 Primary 节点,不会因主从切换而影响应用的读写操作。
命令格式:
Plain Text
1mongo "ConnectionStringURI"
示例:
Plain Text
1mongo "mongodb://root:****@XQgIftoqm.mongodb.bj.baidubce.com:27017,XQgIft8n4.mongodb.bj.baidubce.com:27017/admin?replicaSet=rep-zNo2RD"
Plain Text
1说明:
2ConnectionStringURI:实例的高可用链接地址。
- 单节点连接方式
在日常测试过程中,可以直接连接 Primary / Secondary 节点进行访问。需要注意,当发生主从切换,连接节点的角色将随之发生变化,可能导致读写操作收到影响。
命令格式:
Plain Text
1mongo --host <host> -u <username> -p --authenticationDatabase <database>
Plain Text
1说明:
2<host>:Primary节点或Secondary节点的连接地址。
3<username>:MongoDB实例的数据库账号,初始账号为root。
4<database>:鉴权数据库名,即数据库账号所属的数据库。当数据库账号为root时,对应的数据库为admin。
示例
Plain Text
1mongo --host XQgIft8n4.mongodb.bj.baidubce.com:27017 -u root -p **** --authenticationDatabase admin
注意:
- 不建议直接使用 root 帐号连接数据库,您可以 新建数据库帐号 后再连接数据库。
- 如果连接过程中出现鉴权失败,请确认您的密码是否正确,若密码有特殊字符,则需要做urlencode。
- 自 MongoDB 6.0 起,Mongo Shell 已升级为 mongosh。请使用 mongosh 命令连接实例,原 mongo 命令已不再推荐使用。
