- 文档首页
文档数据库 MongoDB 版
用户指南
网络与连接管理
通过 MongoDB shell 工具连接实例
网络与连接管理
通过 MongoDB shell 工具连接实例
通过 MongoDB shell 工具连接实例
成功创建文档数据库 MongoDB 版实例后,您就可以通过 MongoDB shell 工具连接 MongoDB 实例,并进行各种管理操作。
前提条件
- 已在本地或 ECS 实例上安装正确版本的 MongoDB shell 工具:
- MongoDB 5.0 及以上:具体安装步骤,请参见 mongosh。
- 已创建 MongoDB 实例。实例创建方法,请参见创建实例。
- 为 MongoDB 实例设置白名单分组,并将客户端设备 IP 地址加入到实例的白名单中。详细操作步骤,请参见设置白名单。
- 若您的客户端设备和 MongoDB 实例不在同一个 VPC 内,您还要为 MongoDB 实例申请公网连接地址。公网地址申请方法,请参见申请公网连接地址。
操作步骤
- 根据实例类型,在左侧导航栏中选择副本集实例列表或分片集实例列表。
- 找到需要使用的连接地址类型,单击连接地址后的
图标进行复制。
说明
- 您可以根据业务实际情况,将连接地址中的 <user> 和 <password> 改为对应的数据库账号和密码。您可以在账号管理页签下查看和管理账号。具体操作步骤,请参见查看账号信息。
- 文档数据库 MongoDB 版创建成功后,系统会默认在 admin 数据库中创建一个超级管理员账号 root,因此 MongoDB 的默认连接地址中 authSource 值为 admin(即会默认连接到 admin 库)。
- 若您自行创建的账号属于其他数据库(如 testdb1),您需要将 authSource 后的 admin 改为自建账号所在的数据库(如 testdb1)。创建账号的具体步骤,请参见创建账号。
- 为保证重连机制,文档数据库 MongoDB 版在每个连接地址的最后都默认添加了 retryWrites=true 字段。
- 在安装了 MongoDB shell 的本地服务器或 ECS 中,输入如下命令连接 MongoDB 实例。
说明
如下示例中以 MongoDB 5.0 连接工具 mongosh 使用分片集群的私网连接地址为例。 - 登录后若出现如下信息,即表示已通过 MongoDB shell 已成功连接文档数据库 MongoDB 版实例。
常见问题
最近更新时间:2026.09.14 16:02:42