成功创建文档数据库 MongoDB 版实例后，您就可以通过 Mongo Shell 工具连接 MongoDB 实例，并进行各种管理操作。

前提条件

• 已在本地或 ECS 实例上安装正确版本的 Mongo Shell 工具：
  • MongoDB 4.x：具体安装步骤，请参见 The mongo Shell。
  • MongoDB 5.0 及以上：具体安装步骤，请参见 MongoDB Shell。
• 已创建 MongoDB 实例。实例创建方法，请参见创建实例。
• 为 MongoDB 实例设置白名单分组，并将客户端设备 IP 地址加入到实例的白名单中。详细操作步骤，请参见设置白名单。
• 若您的客户端设备和 MongoDB 实例不在同一个 VPC 内，您还要为 MongoDB 实例申请公网连接地址。公网地址申请方法，请参见申请公网连接地址。

操作步骤

1. 登录 MongoDB 控制台。

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

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

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

5. 在实例详情页，单击连接管理页签。

6. 找到需要使用的连接地址类型，单击连接地址后的图标进行复制。

   说明

   • 关于连接地址类型的更多说明，请参见连接地址类型。
   • 您可以根据业务实际情况，将连接地址中的 <user> 和 <password> 改为对应的数据库账号和密码。您可以在账号管理页签下查看和管理账号。具体操作步骤，请参见查看账号信息。
   • 文档数据库 MongoDB 版创建成功后，系统会默认在 admin 数据库中创建一个超级管理员账号 root，因此 MongoDB 的默认连接地址中 authSource 值为 admin（即会默认连接到 admin 库）。
   • 若您自行创建的账号属于其它数据库（如 testdb1），您需要将 authSource 后的 admin 改为自建账号所在的数据库（如 testdb1）。创建账号的具体步骤，请参见创建账号。
   • 为保证重连机制，文档数据库 MongoDB 版在每个连接地址的最后都默认添加了 retryWrites=true 字段。

7. 在安装了 Mongo Shell 的本地服务器或 ECS 中，输入如下命令连接 MongoDB 实例。
   连接工具版本不同，连接命令也不同，其中：

   • MongoDB 4.x 版本连接工具 The mongo Shell

     mongo "<步骤 5 中复制并修改了账号名称和密码的连接地址>"
     

   • MongoDB 5.0 及以上版本连接工具 MongoDB Shell

     mongosh "<步骤 5 中复制并修改了账号名称和密码的连接地址>"
     

   示例如下。

   说明

   如下示例中以 MongoDB 5.0 连接工具 MongoDB Shell 使用分片集群的私网连接地址为例。

   mongosh "mongodb://root:Pwd_123@mongoshardcn01e8ab0d20c****.mongodb.ivolces.com:3717,mongoshardcn01e8ab0d20c****.mongodb.ivolces.com:3717/?authSource=admin&connect=direct&retryWrites=true"
   

8. 登录后若出现如下信息，即表示已通过 Mongo Shell 已成功连接文档数据库 MongoDB 版实例。

   • 若连接的是副本集实例

     rs-实例ID：PRIMARY>
     

   • 若连接的是分片集群实例的 Mongos 节点

     mongos>
     

常见问题

创建与已删除数据库同名的新数据库后，读写数据时为什么会失败？