Mongo Shell是MongoDB自带的数据库管理工具,您可以将Mongo Shell工具下载并安装至客户端(本地服务器或ECS服务器),用于连接云数据库MongoDB Serverless实例。本文介绍通过Mongo Shell连接云数据库MongoDB Serverless实例的方法。
前提条件
已创建云数据库MongoDB Serverless实例。注意事项
云数据库MongoDB Serverless实例提供的默认数据库admin,用于管理admin数据库账号(即创建云数据库MongoDB Serverless实例生成的账号)的信息,不支持进行任何操作。您在使用云数据库MongoDB Serverless实例时,需要先创建admin之外的数据库,然后对该数据库进行操作。
准备工作
- 下载并安装与云数据库MongoDB实例数据库版本相同的Mongo Shell工具至客户端(本地服务器或云服务器ECS实例),下载链接和安装方法,请参见MongoDB Shell Download和The mongo Shell。
如果应用部署在ECS实例,您需要确保云数据库MongoDB实例和ECS实例满足以下条件,以保证网络的连通性。ECS实例信息的查看方法请参见查看实例信息。
- 所在地域相同,并建议所在可用区相同(以减少网络延时)。
- 网络类型为专有网络,需确保使用相同的专有网络ID。
说明 如果ECS实例的网络类型为 经典网络,您可以将ECS实例网络类型转换为专有网络,具体请参见 ECS实例从经典网络迁移到专有网络。
- 将客户端IP地址添加至云数据库MongoDB实例的白名单中,添加方法请参见设置白名单。
说明 如果您需要使用公网地址连接云数据库MongoDB实例,您可以手动申请公网地址,申请方法请参见 申请公网连接地址。
操作步骤
- 登录MongoDB管理控制台。
- 在左侧导航栏,单击Serverless实例列表。
- 在页面左上角,选择实例所在的资源组和地域。
- 单击目标实例ID或目标实例所在行操作列的管理。
- 在目标实例页面的左侧导航栏,单击数据库连接。
- 查看并获取云数据库MongoDB Serverless实例的连接地址,详情请参见获取数据库连接地址。
- 执行如下命令,在安装有MongoDB的客户端(本地服务器或ECS实例)上连接云数据库MongoDB Serverless实例。
mongo --host <host> --port <port> -u <username> -p --authenticationDatabase <authenticationDatabase>
参数说明:<host>
:节点的域名信息。<port>
:节点的端口。<username>
:数据库账号的名称,默认为root。<authenticationDatabase>
:鉴权数据库名称,用于指定数据库账号所属的数据库。当数据库账号为root时,对应的数据库为admin。重要 数据库账号必须在所属的数据库下进行鉴权,才能鉴权成功。
示例:
mongo --host dds-bp1mjur6cuum****.mongodb.rds.aliyuncs.com --port 3717 -u user5495**** -p --authenticationDatabase admin
- 回显如下信息,输入数据库账号对应的密码并按Enter。
Enter password:<password>
参数说明:
<password>
为Serverless实例数据库账号的密码。输入密码时,密码不可见。说明 如果没有设置或忘记密码,您可以设置或修改密码,具体方法请参见 重置密码。回显如下类似信息,说明连接成功。说明 使用不同版本MongoDB中的Mongo Shell连接实例后回显信息不同,请以实际情况为准。connecting to: mongodb://dds-bp1mjur6cuum****.mongodb.rds.aliyuncs.com:3717/?compressors=disabled&gssapiServiceName=mongodb Implicit session: session { "id" : UUID("26c55fd4-5215-4e8a-b07e-2647146c****") } MongoDB server version: 4.2.10
说明 实例连接成功后,建议您使用admin之外的数据库实现业务需求。