通过自建账号连接实例

本文以 Mongo Shell 连接工具为例，介绍如何通过自建账号（即非 root 账号）连接 MongoDB 实例。

前提条件

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

  • MongoDB 4.0：具体安装步骤，请参见 The mongo Shell。

  • MongoDB 5.0：具体安装步骤，请参见 MongoDB Shell。

操作步骤

1. 登录 MongoDB 控制台。
2. 在顶部菜单栏的左上角，选择实例所属的项目和地域。
3. 根据实例类型，在左侧导航栏中选择副本集实例列表或分片集实例列表。
4. 在目标实例类型列表页，单击目标实例名称。

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

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

   说明

   • 您可以根据业务实际情况，将连接地址中的<user>和<password>改为自建账号的名称和密码。
   • 默认连接地址中authSource值为admin（即会默认连接到admin库），若自建账号属于其他数据库（如testdb1），您需要将authSource后admin改为自建账号所在的数据库。
   • 为保证重连机制，文档数据库 MongoDB 版在每个连接地址的最后都默认添加了&retryWrites=true字段。

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

   • MongoDB 4.0 连接工具 The mongo Shell

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

   • MongoDB 5.0 连接工具 MongoDB Shell

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

   示例如下。

   说明

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

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

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

   • 若连接的是副本集实例

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

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

     mongos>