通过 Mongo Shell 工具连接实例

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

前提条件

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

操作步骤

1. 登录 MongoDB 控制台。
2. 在顶部菜单栏的左上角，选择实例所属的项目和地域。
3. 在实例列表页，单击目标实例名称。
4. 在实例详情页，单击连接管理页签。
5. 找到需要使用的连接地址类型，单击连接地址后的复制图标进行复制。

   说明

   • 关于连接地址类型的更多说明，请参见连接地址类型。
   • 您可以根据业务实际情况，将连接地址中的 <user> 和 <password> 改为对应的数据库账号和密码。您可以在账号管理页签下查看账号名称和修改密码。
   • 为保证重连机制，文档数据库 MongoDB 版在每个连接地址的最后都默认添加了 &retryWrites=true 字段。
6. 在安装了 Mongo Shell 的本地服务器或 ECS 中，输入如下命令连接 MongoDB 实例。

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

   示例（以分片集群的私网连接地址为例）如下。

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

7. 登录后若出现如下信息，即表示已通过 Mongo Shell 已成功连文档数据库实例。
   • 若连接的是副本集实例

     rs-mongo-replica-实例ID：PRIMARY>
     

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

     mongos>
     

常见问题

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