更新时间:2023-12-12 GMT+08:00

通过Mongo Shell连接副本集实例(内网连接)

Mongo Shell是MongoDB自带的Shell客户端,您可以使用Mongo Shell连接数据库实例、对数据库进行数据查询和更新、执行管理等操作。 Mongo Shell是MongoDB客户端的一部分,您需要先下载和安装MongoDB客户端,再使用Mongo Shell连接数据库实例

DDS实例默认提供内网IP地址,当应用部署在弹性云服务器上,且该弹性云服务器与文档数据库实例处于同一区域,同一VPC时,可以使用内网连接文档数据库实例,该方式可以获得更快的传输速率和更高的安全性。

本章节以部署在弹性云服务器上的应用场景为例,介绍如何使用Mongo Shell通过内网的方式连接副本集实例。

连接副本集实例的方式有SSL连接和非SSL连接两种方法,其中SSL连接通过了加密功能,具有更高的安全性。为了提升数据在网络传输过程中的安全性,建议采用SSL方式。

前提条件

  1. 创建并登录弹性云服务器,具体操作请参见购买弹性云服务器登录弹性云服务器
  2. 弹性云服务器上,安装MongoDB客户端。为了保障鉴权成功,请安装与目标实例版本一致的MongoDB客户端版本。

    安装MongoDB客户端,请参见如何安装MongoDB客户端

  3. 已确保弹性云服务器和DDS实例实现网络互通,详情请参见设置安全组规则

SSL连接

使用SSL方式连接,请务必开启SSL连接,否则会报错。关于如何开启SSL连接,请参见开启和关闭SSL连接

  1. 登录管理控制台
  2. 单击管理控制台左上方的,选择区域和项目。
  3. 在页面左上角单击,选择数据库 > 文档数据库服务 DDS,进入文档数据库服务信息页面。
  4. “实例管理”页面,单击实例名称。
  5. 在左侧导航树,单击“连接管理”
  6. “基本信息”区域的“SSL”处,单击,下载根证书。
  7. 上传根证书至需要连接实例的弹性云服务器

    根据客户端使用的计算机系统类型,选择相应的上传方法。

    • Linux操作系统下,可参考如下命令:
      scp<IDENTITY_FILE><REMOTE_USER>@<REMOTE_ADDRESS>:<REMOTE_DIR>
      • IDENTITY_FILE为存储根证书的文件目录,该文件目录权限为600。
      • REMOTE_USER为弹性云服务器的操作系统用户。
      • REMOTE_ADDRESS为弹性云服务器的主机地址。
      • REMOTE_DIR为将根证书上传到弹性云服务器的文件目录。
    • Windows操作系统下,请使用远程连接工具上传根证书。

  8. 连接数据库实例。

    方式一:高可用连接(推荐)

    DDS管理控制台界面提供了高可用连接地址。通过该地址连接副本集实例,不仅提升了数据读写性能,而且避免了在发生主备节点切换后,从客户端写入数据报错的问题。

    命令格式:

    ./mongo "<内网高可用连接地址>" --ssl --sslCAFile<FILE_PATH> --sslAllowInvalidHostnames

    相关参数说明如下:

    • 内网高可用连接地址:您可以在实例管理页面,单击目标实例名称,进入基本信息页面。单击连接管理 > 内网连接,在“内网高可用连接地址”处即可获取到当前实例的连接地址。
      图1 获取内网高可用地址

      获取到的内网高可用地址格式如下,该连接地址采用固定的账号和数据库进行认证,即账号名rwuser及认证数据库admin不可修改。

      mongodb://rwuser:<password>@192.168.xx.xx:8635,192.168.xx.xx:8635/test?authSource=admin&replicaSet=replica

      您需要关注内网高可用地址中的如下参数:

      表1 参数说明

      参数名称

      说明

      rwuser

      账号名,即数据库账号。

      <password>

      数据库账号对应的密码,需要替换为真实密码。

      如果密码中包含特殊字符“@”、“!”、“$”和“%”需要分别替换为对应的十六进制的URL编码(ASCII码)“%40”、“%21”、“%24”和“%25”。

      示例:密码为****@%***!$,对应的URL编码为****%40%25***%21%24。

      192.168.xx.xx:8635,192.168.xx.xx:8635

      待连接副本集实例的节点IP地址及端口号。

      test

      表示测试库名,可根据实际情况设置。

      authSource=admin&replicaSet=replica

      • rwuser账号认证数据库必须为“admin”,即“authSource=admin”为固定格式不可改变。
      • “replicaSet=replica”中的“replica”是副本集的名称。华为云DDS的副本集统一默认为“replica”。
    • FILE_PATH:存放根证书的路径。
    • --sslAllowInvalidHostnames:为了保证副本集内部通讯不占用用户IP地址和带宽等资源,副本集证书使用内部管理IP地址生成。通过内网SSL连接副本集实例时,需要添加“--sslAllowInvalidHostnames”。

    连接命令示例:

    ./mongo "mongodb://rwuser:<password>@192.168.xx.xx:8635,192.168.xx.xx:8635/test?authSource=admin&replicaSet=replica" --ssl --sslCAFile/tmp/ca.crt --sslAllowInvalidHostnames

    返回如下信息,表示实例已连接成功:
    replica:PRIMARY>

    执行如下命令,进入local库:

    use local

    回显信息如下:

    switched to db local

    执行如下命令,查询副本集oplog:

    db.oplog.rs.find()

    方式二:内网高可用连接(用户自定义数据库及账号)

    命令格式:

    ./mongo "<内网高可用连接地址>" --ssl --sslCAFile<FILE_PATH> --sslAllowInvalidHostnames

    相关参数说明如下:

    • 内网高可用连接地址:您可以在实例管理页面,单击目标实例名称,进入基本信息页面。单击连接管理 > 内网连接,在“内网高可用连接地址”处即可获取到当前实例的连接地址。
      图2 获取内网高可用地址

      获取到的内网高可用地址格式如下:

      mongodb://rwuser:<password>@192.168.xx.xx:8635,192.168.xx.xx:8635/test?authSource=admin&replicaSet=replica

      您需要关注内网高可用地址中的如下参数信息:

      表2 参数信息

      参数名称

      说明

      rwuser

      数据库账号名,默认为“rwuser”。可根据实际情况修改为用户创建的账号名。

      <password>

      表示数据库账号对应的密码,需要替换为真实密码。

      如果密码中包含特殊字符“@”、“!”、“$”和“%”需要分别替换为对应的十六进制的URL编码(ASCII码)“%40”、“%21”、“%24”和“%25”。

      示例:密码为****@%***!$,对应的URL编码为****%40%25***%21%24。

      192.168.xx.xx:8635,192.168.xx.xx:8635

      待连接副本集实例的节点IP地址及端口号。

      test

      表示测试库名,可根据实际情况设置。

      authSource=admin&replicaSet=replica

      • rwuser账号认证数据库为“admin”。
      • “replicaSet=replica”中的“replica”代表实例类型为副本集,且格式固定不可修改。
      说明:

      若用户使用自定义创建的数据库进行认证,则需将高可用连接地址中认证数据库改为当前创建的数据库名称。且须将该表格的第一行参数“数据库账号名”修改为当前数据库下创建的账号名。

    • FILE_PATH:存放根证书的路径。
    • --sslAllowInvalidHostnames:为了保证副本集内部通讯不占用用户IP地址和带宽等资源,副本集证书使用内部管理IP地址生成。通过内网SSL连接副本集实例时,需要添加“--sslAllowInvalidHostnames”。

    例如用户自定义创建数据库Database并在该数据库下创建账号test1,则连接命令示例为:

    ./mongo "mongodb://test1:<password>@192.168.xx.xx:8635,192.168.xx.xx:8635/Database?authSource=Database&replicaSet=replica" --ssl --sslCAFile/tmp/ca.crt --sslAllowInvalidHostnames

    方式三:单个节点连接

    您也可以通过单个主节点或备节点的内网IP地址访问副本集实例,该种方法在发生主备切换时,会影响数据的读写性能。

    命令格式:

    ./mongo --host <DB_HOST> --port <DB_PORT> -u <DB_USER> -p --authenticationDatabase admin --ssl --sslCAFile<FILE_PATH> --sslAllowInvalidHostnames

    相关参数说明如下:

    • DB_HOST:待连接实例主节点或备节点的内网IP地址。

      主节点:即Primary节点,连接该节点后可执行数据的读写操作。

      备节点:即Secondary节点,连接该节点后仅可执行数据的读操作。

      您可以在实例管理页面,单击目标实例名称,进入基本信息页面。在连接管理 > 内网连接页签下获取对应节点的IP地址。

      图3 获取节点IP地址
    • DB_PORT:数据库端口,默认为8635。

      您可以单击目标实例名称,进入基本信息页面。在左侧导航树中单击连接管理,在内网连接页签,在基本信息 > 数据库端口处获取实际端口号。

      图4 获取端口
    • DB_USER:数据库账号,默认为rwuser。
    • FILE_PATH:存放根证书的路径。
    • --sslAllowInvalidHostnames:为了保证副本集内部通讯不占用用户IP地址和带宽等资源,副本集证书使用内部管理IP地址生成。通过内网SSL连接副本集实例时,需要添加“--sslAllowInvalidHostnames”。

    出现如下提示时,输入数据库账号对应的密码:

    Enter password:

    连接命令示例:

    ./mongo --host 192.168.xx.xx --port 8635 -u rwuser -p --authenticationDatabase admin --ssl --sslCAFile /tmp/ca.crt --sslAllowInvalidHostnames

    返回如下信息,表示已成功连接对应的节点:

    • 针对副本集主节点的连接结果:
      replica:PRIMARY>
    • 针对副本集备节点的连接结果:
      replica:SECONDARY>

非SSL连接

使用非SSL方式连接实例时,请务必关闭SSL连接,否则会报错。关于如何关闭SSL连接,请参见开启和关闭SSL连接

  1. 登录弹性云服务器
  2. 连接文档数据库实例

    方式一:高可用连接(推荐)

    DDS管理控制台界面提供了高可用连接地址。通过该地址连接副本集实例,不仅提升了数据读写性能,而且避免了在发生主备节点切换后,从客户端写入数据报错的问题。

    命令格式:

    ./mongo "<内网高可用连接地址>"

    内网高可用连接地址:您可以在实例管理页面,单击目标实例名称,进入基本信息页面。单击连接管理 > 内网连接,在“内网高可用连接地址”处即可获取到当前实例的连接地址。

    图5 获取内网高可用地址

    获取到的内网高可用地址格式如下,该连接地址采用固定的账号和数据库进行认证,即账号名rwuser及认证数据库admin不可修改。

    mongodb://rwuser:<password>@192.168.xx.xx:8635,192.168.xx.xx:8635/test?authSource=admin&replicaSet=replica

    您需要关注内网高可用地址中的如下参数:

    表3 参数说明

    参数名称

    说明

    rwuser

    账号名,即数据库账号。

    <password>

    数据库账号对应的密码,需要替换为真实密码。

    如果密码中包含特殊字符“@”、“!”、“$”和“%”需要分别替换为对应的十六进制的URL编码(ASCII码)“%40”、“%21”、“%24”和“%25”。

    示例:密码为****@%***!$,对应的URL编码为****%40%25***%21%24。

    192.168.xx.xx:8635,192.168.xx.xx:8635

    待连接副本集实例的节点IP地址及端口号。

    test

    表示测试库名,可根据实际情况设置。

    authSource=admin&replicaSet=replica

    • rwuser账号认证数据库必须为“admin”,即“authSource=admin”为固定格式不可改变。
    • “replicaSet=replica”中的“replica”是副本集的名称。华为云DDS的副本集统一默认为“replica”。

    连接命令示例:

    ./mongo "mongodb://rwuser:<password>@192.168.xx.xx:8635,192.168.xx.xx:8635/test?authSource=admin&replicaSet=replica"

    返回如下信息,表示实例已连接成功:
    replica:PRIMARY>

    执行如下命令,进入local库:

    use local

    回显信息如下:

    switched to db local

    执行如下命令,查询副本集oplog:

    db.oplog.rs.find()

    方式二:内网高可用连接(用户自定义数据库及账号)

    命令格式:

    ./mongo "<内网高可用连接地址>"

    内网高可用连接地址:您可以在实例管理页面,单击目标实例名称,进入基本信息页面。单击连接管理 > 内网连接,在“内网高可用连接地址”处即可获取到当前实例的连接地址。

    图6 获取内网高可用地址

    获取到的内网高可用地址格式如下:

    mongodb://rwuser:<password>@192.168.xx.xx:8635,192.168.xx.xx:8635/test?authSource=admin&replicaSet=replica

    您需要关注内网高可用地址中的如下参数信息:

    表4 参数信息

    参数名称

    说明

    rwuser

    数据库账号名,默认为“rwuser”。可根据实际情况修改为用户创建的账号名。

    <password>

    表示数据库账号对应的密码,需要替换为真实密码。

    如果密码中包含特殊字符“@”、“!”、“$”和“%”需要分别替换为对应的十六进制的URL编码(ASCII码)“%40”、“%21”、“%24”和“%25”。

    示例:密码为****@%***!$,对应的URL编码为****%40%25***%21%24。

    192.168.xx.xx:8635,192.168.xx.xx:8635

    待连接副本集实例的节点IP地址及端口号。

    test

    表示测试库名,可根据实际情况设置。

    authSource=admin&replicaSet=replica

    • rwuser账号认证数据库为“admin”。
    • “replicaSet=replica”中的“replica”代表实例类型为副本集,且格式固定不可修改。
    说明:

    若用户使用自定义创建的数据库进行认证,则需将高可用连接地址中认证数据库改为当前创建的数据库名称。且须将该表格的第一行参数“数据库账号名”修改为当前数据库下创建的账号名。

    例如用户自定义创建数据库Database并在该数据库下创建账号test1,则连接命令示例为:

    ./mongo "mongodb://test1:<password>@192.168.xx.xx:8635,192.168.xx.xx:8635/Database?authSource=Database&replicaSet=replica"

    方式三:单个节点连接

    您也可以通过单个主节点或备节点的内网IP地址访问副本集实例,该种方法在发生主备切换时,会影响数据的读写性能。

    命令格式:

    ./mongo --host <DB_HOST> --port <DB_PORT> -u <DB_USER> -p --authenticationDatabase admin

    相关参数说明如下:

    • DB_HOST:待连接实例主节点或备节点的内网IP地址。

      主节点:即Primary节点,连接该节点后可执行数据的读写操作。

      备节点:即Secondary节点,连接该节点后仅可执行数据的读操作。

      您可以在实例管理页面,单击目标实例名称,进入基本信息页面。在连接管理 > 内网连接页签下获取对应节点的IP地址。

      图7 获取节点IP地址
    • DB_PORT:数据库端口,默认为8635。

      您可以单击目标实例名称,进入基本信息页面。在左侧导航树中单击连接管理,在内网连接页签,在基本信息 > 数据库端口处获取实际端口号。

      图8 获取端口
    • DB_USER:数据库账号,默认为rwuser。

    连接命令示例:

    ./mongo --host 192.168.xx.xx --port 8635 -u rwuser -p --authenticationDatabase admin

    出现如下提示时,输入数据库账号对应的密码:

    Enter password:

    返回如下信息,表示对应的节点已经连接成功:

    • 针对副本集主节点的连接结果:
      replica:PRIMARY>
    • 针对副本集备节点的连接结果:
      replica:SECONDARY>