通过Mongo Shell连接集群实例只读节点

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

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

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

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

SSL连接

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

1. 在“实例管理”页面，单击实例名称。
2. 在左侧导航树，单击“连接管理”。
3. 在“基本信息”区域的“SSL”处，单击，下载根证书。
4. 上传根证书至需要连接实例的弹性云服务器。

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

   • Linux操作系统下，可参考如下命令：
     scp<IDENTITY_FILE><REMOTE_USER>@<REMOTE_ADDRESS>:<REMOTE_DIR>

     

     • IDENTITY_FILE为存储根证书的文件目录，该文件目录权限为600。
     • REMOTE_USER为弹性云服务器的操作系统用户。
     • REMOTE_ADDRESS为弹性云服务器的主机地址。
     • REMOTE_DIR为将根证书上传到弹性云服务器的文件目录。
   • Windows操作系统下，请使用远程连接工具上传根证书。

5. 连接数据库实例。DDS管理控制台界面提供了只读节点连接地址，建议通过该地址连接集群实例只读节点。

   命令格式：

   ./mongo "<Readonly_node连接地址>" --ssl --sslCAFile<FILE_PATH> --sslAllowInvalidHostnames

   相关参数说明如下：

   • Readonly_node连接地址：您可以在实例管理页面，单击目标实例名称，进入基本信息页面。单击“连接管理 > 内网连接”，在“连接地址”处即可获取到当前实例只读节点的连接地址。
     图1 获取内网Readonly_node连接地址
     

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

     mongodb://rwuser:<password>@192.168.xx.xx:8635,192.168.xx.xx:8635/test?authSource=admin&readPreference=secondaryPreferred&readPreferenceTags=role:readonly

     您需要关注Readonly_node连接地址中的如下参数：

     表1 参数说明

     参数名称	说明
     rwuser	帐号名，即数据库帐号。
     <password>	数据库帐号对应的密码，需要替换为真实密码。 如果密码中包含特殊字符“@”、“!”、“$”和“%”需要分别替换为对应的十六进制的URL编码（ASCII码）“%40”、“%21”、“%24”和“%25”。 示例：密码为****@%***!$，对应的URL编码为****%40%25***%21%24。
     192.168.xx.xx:8635,192.168.xx.xx:8635	待连接集群实例的mongos节点IP地址及端口号。
     test	表示测试库名，可根据实际情况设置。
     authSource=admin	rwuser帐号认证数据库必须为“admin”，即“authSource=admin”为固定格式不可改变。

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

   连接命令示例：

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

   

   通过Readonly_node连接地址连接实例时，需要在连接信息前后添加英文双引号。

   返回如下信息，表示实例已连接成功：

   mongos>

非SSL连接

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

1. 登录弹性云服务器。
2. 连接文档数据库实例。DDS管理控制台界面提供了只读节点连接地址，通过该地址连接集群实例只读节点。

   命令格式：

   ./mongo "<Readonly_node连接地址>"

   Readonly_node连接地址：您可以在实例管理页面，单击目标实例名称，进入基本信息页面。单击“连接管理 > 内网连接”，在“连接地址”处即可获取到当前实例只读节点的连接地址。

   图2 获取内网Readonly_node连接地址
   

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

   mongodb://rwuser:<password>@192.168.xx.xx:8635,192.168.xx.xx:8635/test?authSource=admin&readPreference=secondaryPreferred&readPreferenceTags=role:readonly

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

   表2 参数说明

   参数名称	说明
   rwuser	帐号名，即数据库帐号。
   <password>	数据库帐号对应的密码，需要替换为真实密码。 如果密码中包含特殊字符“@”、“!”、“$”和“%”需要分别替换为对应的十六进制的URL编码（ASCII码）“%40”、“%21”、“%24”和“%25”。 示例：密码为****@%***!$，对应的URL编码为****%40%25***%21%24。
   192.168.xx.xx:8635,192.168.xx.xx:8635	待连接集群实例的mongos节点IP地址及端口号。
   test	表示测试库名，可根据实际情况设置。
   authSource=admin	rwuser帐号认证数据库必须为“admin”，即“authSource=admin”为固定格式不可改变。

   连接命令示例：

   ./mongo "mongodb://rwuser:<password>@192.168.xx.xx:8635,192.168.xx.xx:8635/test?authSource=admin&readPreference=secondaryPreferred&readPreferenceTags=role:readonly"

   返回如下信息，表示实例已连接成功：

   mongos>