Mongo Shell是MongoDB自带的数据库管理工具,您可以下载Mongo Shell工具并安装至客户端(本地服务器或ECS服务器),用于连接云数据库MongoDB副本集实例。

前提条件

已创建云数据库MongoDB副本集实例,创建方法请参见创建副本集实例

背景信息

云数据库MongoDB副本集实例提供的默认数据库admin,存储了实例的所有数据库账号和角色信息,建议使用admin之外的数据库实现业务需求(即不对admin库进行任何操作)。

准备工作

  • 下载并安装与云数据库MongoDB实例数据库版本相同的Mongo Shell工具至客户端(本地服务器或云服务器ECS实例),下载链接,请参见Index of mongodb-org
    如果应用部署在ECS实例,您需要确保云数据库MongoDB实例和ECS实例满足以下条件,以保证网络的连通性。ECS实例信息的查看方法请参见查看实例信息
    • 所在地域相同,并建议所在可用区相同(以减少网络延时)。
    • 网络类型相同。
      说明
      • 专有网络具有更高的安全性,建议使用专有网络。
      • 如果网络类型为专有网络,需确保使用相同的专有网络ID。
      • 如果您需要使用专有网络,但ECS实例的网络类型为经典网络,您可以将ECS实例网络类型转换为专有网络,具体请参见ECS实例从经典网络迁移到专有网络
  • 将客户端IP地址添加至云数据库MongoDB实例的白名单中,添加方法请参见设置白名单
  • 如果您需要使用公网地址连接云数据库MongoDB实例,可以手动申请公网地址,申请方法请参见(可选)申请公网连接地址
  • 如果需要连接只读节点,请确保云数据库MongoDB实例中已存在只读节点,如果没有,您可以添加只读节点,添加方法请参见变更副本集实例配置

操作步骤

  1. 登录MongoDB管理控制台
  2. 在左侧导航栏,单击副本集实例列表
  3. 在页面左上角,选择实例所在的资源组和地域。
  4. 单击目标实例ID或目标实例所在行操作列的管理
  5. 在目标实例页面的左侧导航栏,单击数据库连接
  6. 查看并获取云数据库MongoDB副本集实例的连接地址。
    连接地址
    项目 说明
    地址类型
    • 私网连接
      • 专有网络:专有网络是一种隔离的网络环境,安全性和性能均高于传统的经典网络。 云数据库MongoDB实例默认提供专有网络连接地址,通过专有网络连接云数据库MongoDB实例可以获取更高的安全性和性能。
      • 经典网络:云服务在网络上不进行隔离,仅依靠云服务自身的安全组或白名单策略阻挡非法访问。
    • 公网连接:由于通过公网连接实例存在一定的安全风险,云数据库MongoDB实例默认未提供公网连接地址。如果您需要通过公网连接云数据库MongoDB实例,可以手动申请公网连接地址,申请方法请参见(可选)申请公网连接地址
    Primary 主节点,连接主节点地址可以执行数据库的读写操作。当主节点出现故障时,会发生主备切换,您需要连接新的主节点确保读写操作不受影响。
    格式:
    <host>:<port>
    参数说明:
    • <host>:主节点的域名信息
    • <port>:主节点的端口
    示例:
    dds-bp19f409d7512****.mongodb.rds.aliyuncs.com:3717
    Secondary 从节点,连接从节点地址仅能执行数据库的读操作。
    格式:
    <host>:<port>
    参数说明:
    • <host>:从节点的域名信息
    • <port>:从节点的端口
    示例:
    dds-bp19f409d7512****.mongodb.rds.aliyuncs.com:3717
    ReadOnly 只读节点,连接只读节点地址仅能执行数据库的读操作。
    说明 只有实例中已存在只读节点时,您才可以看到只读节点的地址。
    格式:
    <host>:<port>
    参数说明:
    • <host>:实例只读节点的域名信息
    • <port>:实例只读节点的端口
    示例:
    dds-bp19f409d7512****.mongodb.rds.aliyuncs.com:3717
    ReadOnly ConnectionStringURI 实例的高可用地址,实现负载均衡及高可用,连接高可用地址可以执行数据库的读写操作。在具有多个只读节点的情况下,建议应用程序通过该地址连接实例。
    说明
    • 只有实例中已存在只读节点时,您才可以看到ReadOnly ConnectionStringURI地址。
    • 通过ReadOnly ConnectionStringURI地址连接实例,会优先将读请求发送到只读节点。
    • 当实例中的某个只读节点出现故障时,读请求会自动切换到下一个只读节点(ReadOnly),不会影响应用的读操作。如果所有的只读节点都出现了故障,读请求会切换到从节点(Secondary)。
    格式:
    mongodb://<username>:<password>@<host1>:<port1>,<host2>:<port2>,...,<hostN>:<portN>/<database>?readPreference=secondary&readPreferenceTags=<readonly_Tags>&replicaSet=<replicaSet_value>
    参数说明:
    • <username>:数据库账号的名称,默认为root。
    • <password>:数据库账号的密码。
    • <host>:只读节点(ReadOnly)的域名信息
    • <port>:只读节点(ReadOnly)的端口
    • <database>:数据库账号所属的数据库名称,默认为admin。

      如果您需要使用其他数据库,请在连接地址末尾添加&authSource=admin

    • readPreference=secondary:实现读写分离和负载均衡,该参数可以将写请求发送到主节点(Primary),读请求随机发送到从节点(Secondary)和只读节点(ReadOnly)。
    • readPreferenceTags=<readonly_Tags><readonly_Tags>为只读节点(ReadOnly)的标签键值对列表,不允许修改。该参数可以将读请求优先发送到标签对应的只读节点(ReadOnly)。
      说明 readPreferenceTags参数的详细信息,请参见Connection String URI Format
    • replicaSet=<replicaSet_value><replicaSet_value>为实例高可用连接地址的唯一标识ID。该参数可以将读请求发送到副本集实例的所有节点。
    示例:
    mongodb://root:****@dds-bp19f409d7512****.mongodb.rds.aliyuncs.com:3717/admin?readPreference=secondary&readPreferenceTags=role:readonly&replicaSet=mgset-6108****
    ConnectionStringURI 实例的高可用地址,实现负载均衡及高可用,连接高可用地址可以执行数据库的读写操作。生产环境的应用程序建议通过该地址连接实例。
    说明 通过ConnectionStringURI地址连接实例,可以确保连接的节点始终为主节点(Primary),不会因为主备切换而影响应用的读写操作。
    格式:
    mongodb://<username>:<password>@<host1>:<port1>,<host2>:<port2>,...,<hostN>:<portN>/<database>?replicaSet=<replicaSet_value>
    参数说明:
    • <username>:数据库账号的名称,默认为root。
    • <password>:数据库账号的密码。
    • <host>:主节点(Primary)、从节点(Secondary)和只读节点(ReadOnly )的域名信息
    • <port>:主节点(Primary)、从节点(Secondary)和只读节点(ReadOnly )的端口
    • <database>:数据库账号所属的数据库名称,默认为admin。

      如果您需要使用其他数据库,请在连接地址末尾添加&authSource=admin

    • replicaSet=<replicaSet_value><replicaSet_value>为实例高可用连接地址的唯一标识ID。该参数可以将读请求发送到副本集实例的所有节点。
    示例:
    mongodb://root:****@dds-bp19f409d7512****.mongodb.rds.aliyuncs.com:3717,dds-bp19f409d7512****.mongodb.rds.aliyuncs.com:3717,dds-bp19f409d7512****.mongodb.rds.aliyuncs.com:3717/admin?replicaSet=mgset-61081718-bp1366caac83d****.mongodb.rds.aliyuncs.com:3717,dds-bp1366caac83d****.mongodb.rds.aliyuncs.com:3717,dds-bp1366caac83d****.mongodb.rds.aliyuncs.com:3717/admin?replicaSet=mgset-4581****
  7. 根据业务需要,在安装有Mongo Shell工具的客户端(本地服务器或ECS服务器)上连接云数据库MongoDB副本集实例。
    • 通过高可用地址连接实例

      通过高可用地址连接实例,可以连接实例的所有节点。在单个节点发生故障时,仍然能正常连接实例。

      语法:
      mongo "<连接地址>"    
      参数说明:<连接地址>为实例的ReadOnly ConnectionStringURI地址或ConnectionStringURI地址。
      说明
      • 您需要替换ReadOnly ConnectionStringURI地址或ConnectionStringURI地址中的****为root账号的密码。如果您忘记了root账号的密码,可以重新设置密码,设置方法请参见(可选)重置密码
      • Mongo Shell不能识别ReadOnly ConnectionStringURI连接地址中的readPreferencereadPreferenceTags参数,故使用该地址连接实例时,会自动连接实例的主节点(Primary)。
      以ConnectionStringURI为例,执行如下命令:
      mongo "mongodb://root:****@dds-bp19f409d7512****.mongodb.rds.aliyuncs.com:3717,dds-bp19f409d7512****.mongodb.rds.aliyuncs.com:3717,dds-bp19f409d7512****.mongodb.rds.aliyuncs.com:3717/admin?replicaSet=mgset-6108****"    
    • 通过单节点地址连接实例

      通过单节点地址连接实例,只能连接实例的单个节点。在单个节点发生故障时,将无法连接实例。

      1. 执行连接命令。
        语法:
        mongo --host <host>:<port> -u <username> -p --authenticationDatabase <database>
        参数说明:
        • <host>:主节点(Primary)、从节点(Secondary)或只读节点(ReadOnly )节点的域名信息
        • <port>:主节点(Primary)、从节点(Secondary)或只读节点(ReadOnly )的端口
        • <username>:数据库账号的名称,默认为root。
          说明 不建议直接使用root账号连接数据库。您可以创建数据库账号并分配权限,详情请参见MongoDB数据库账号权限管理
        • <database>:数据库账号所属的数据库名称,默认为admin。
        示例:
        mongo --host dds-bp19f409d7512****.mongodb.rds.aliyuncs.com:3717 -u root -p --authenticationDatabase admin
      2. 输入数据库账号的密码。

        在命令行提示Enter password:时,输入数据库账号的密码并按回车键确认。如果您忘记了root账号的密码,可以重新设置密码,设置方法请参见(可选)重置密码

常见的连接场景

相关问题