You need to enable JavaScript to run this app.
文档中心
文档数据库 MongoDB 版

文档数据库 MongoDB 版

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