# 通过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方式。
#### 前提条件
1. 创建并登录弹性云服务器，具体操作请参见[购买弹性云服务器](https://support.huaweicloud.com/usermanual-ecs/ecs_03_7002.html)和[登录弹性云服务器](https://support.huaweicloud.com/ecs_faq/ecs_faq_0632.html)。
2. 在弹性云服务器上，安装MongoDB客户端。为了保障鉴权成功，请安装与目标实例版本一致的MongoDB客户端版本。 安装MongoDB客户端，请参见[如何安装MongoDB客户端](https://support.huaweicloud.com/dds_faq/dds_faq_0018.html)。
   
3. 已确保弹性云服务器和DDS实例实现网络互通，详情请参见[设置安全组规则](https://support.huaweicloud.com/usermanual-dds/dds_03_0313.html)。
 
#### 操作步骤
- [SSL连接]
  ![](https://support.huaweicloud.com/usermanual-dds/public_sys-resources/notice_3.0-zh-cn.png)
  使用SSL方式连接，请务必开启SSL连接，否则会报错。关于如何开启SSL连接，请参见[开启和关闭SSL连接](https://support.huaweicloud.com/usermanual-dds/dds_03_0074.html)。
  1. [登录管理控制台](https://console.huaweicloud.com)。
  
  2. 单击管理控制台左上方的![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000002050323384.png)，选择区域和项目。
  
  3. 在页面左上角单击![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000002086402553.png)，选择"数据库 \> 文档数据库服务 DDS"，进入文档数据库服务信息页面。
  
  4. 在"实例管理"页面，单击实例名称。
  
  5. 在左侧导航树，单击"连接管理"。
  
  6. 在"基本信息"区域的"SSL"处，单击![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000002050165136.png)，下载根证书。
  
  7. 上传根证书至需要连接实例的弹性云服务器。 
     根据客户端使用的计算机系统类型，选择相应的上传方法。
     - Linux操作系统下，可参考如下命令：
       **scp** *\<IDENTITY_FILE\>* *\<REMOTE_USER\>* **@** *\<REMOTE_ADDRESS\>* **:** *\<REMOTE_DIR\>*
       ![](https://support.huaweicloud.com/usermanual-dds/public_sys-resources/note_3.0-zh-cn.png)
       - IDENTITY_FILE为存储根证书的文件目录，该文件目录权限为600。
       
       - REMOTE_USER为弹性云服务器的操作系统用户。
       
       - REMOTE_ADDRESS为弹性云服务器的主机地址。
       
       - REMOTE_DIR为将根证书上传到弹性云服务器的文件目录。
         
     
     - Windows操作系统下，请使用远程连接工具上传根证书。
     
     
     
     
  
  8. 连接数据库实例。 
     **方式一：高可用连接（推荐）**
     DDS管理控制台界面提供了高可用连接地址。通过该地址连接副本集实例，不仅提升了数据读写性能，而且避免了在发生主备节点切换后，从客户端写入数据报错的问题。
     命令格式：
     ****./mongo**** **"** *\<内网高可用连接地址\>* **"** **--** **ssl --sslCAFile** *\<* *FILE_PATH* *\>* **--sslAllowInvalidHostnames**
     相关参数说明如下：
     - 内网高可用连接地址：您可以在实例管理页面，单击目标实例名称，进入基本信息页面。单击"连接管理 \> 内网连接"，在"内网高可用连接地址"处即可获取到当前实例的连接地址。
       图1获取内网高可用地址   
       ![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000002353630425.png "点击放大")
       获取到的内网高可用地址格式如下，该连接地址采用固定的账号和数据库进行认证，即账号名**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"和"%2B"。 示例：密码为\*\*\*\*@%\*\*\*!$+，对应的URL编码为\*\*\*\*%40%25\*\*\*%21%24%2B。                                                                                                                                           |
       | *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**
     ![](https://support.huaweicloud.com/usermanual-dds/public_sys-resources/note_3.0-zh-cn.png)
     - 通过内网高可用地址连接实例时，需要在连接信息前后添加英文双引号。
     
     - 关于高可用连接方式的更多信息，请参见"[如何连接副本集实例以实现读写分离和高可用](https://support.huaweicloud.com/bestpractice-dds/dds_0003.html)"的内容。
      
     返回如下信息，表示实例已连接成功：
     ```
     replica:PRIMARY>
     ```
     执行如下命令，进入local库：
     **use loca** **l**
     回显信息如下：
     ```
     switched to db local
     ```
     执行如下命令，查询副本集oplog：
     **db.oplog.rs.find()**
     **方式二：内网高可用连接（用户自定义数据库及账号）**
     命令格式：
     ****./mongo**** **"** *\<内网高可用连接地址\>* **"** **--** **ssl --sslCAFile** *\<* *FILE_PATH* *\>* **--sslAllowInvalidHostnames**
     相关参数说明如下：
     - 内网高可用连接地址：您可以在实例管理页面，单击目标实例名称，进入基本信息页面。单击"连接管理 \> 内网连接"，在"内网高可用连接地址"处即可获取到当前实例的连接地址。
       图2获取内网高可用地址   
       ![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000002353630425.png "点击放大")
       获取到的内网高可用地址格式如下：
       **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"和"%2B"。 示例：密码为\*\*\*\*@%\*\*\*!$+，对应的URL编码为\*\*\*\*%40%25\*\*\*%21%24%2B。                                                                                                                                                                       |
       | *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地址访问副本集实例，该种方法在发生[主备切换](https://support.huaweicloud.com/usermanual-dds/dds_03_0050.html)时，会影响数据的读写性能。
     命令格式：
     **./mongo --host** \<*DB_HOST* \> **--port** \<*DB_PORT* \> **-u** \<*DB_USER* \>**-p** **--authenticationDatabase** **admin** **--ssl --sslCAFile** \<*FILE_PATH* \> **--sslAllowInvalidHostnames**
     相关参数说明如下：
     表3参数说明 
     | 参数名称                       | 说明                                                                                                                                                                                                                                                                                                                                                                                         |
     |:---|:---|
     | DB_HOST                    | 待连接实例主节点或备节点的内网IP地址。 主节点：即Primary节点，连接该节点后可执行数据的读写操作。 备节点：即Secondary节点，连接该节点后仅可执行数据的读操作。 您可以在实例管理页面，单击目标实例名称，进入基本信息页面。在"连接管理 \> 内网连接"页签下获取对应节点的IP地址。 图3获取节点IP地址 ![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000002581153942.png "点击放大")  |
     | DB_PORT                    | 数据库端口，默认为8635。 您可以单击目标实例名称，进入基本信息页面。在左侧导航树中单击连接管理，在内网连接页签，在"基本信息 \> 数据库端口"处获取实际端口号。 图4获取端口 ![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000002581000580.png "点击放大")                                                                                                                                   |
     | 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连接]
  ![](https://support.huaweicloud.com/usermanual-dds/public_sys-resources/notice_3.0-zh-cn.png)
  使用非SSL方式连接实例时，请务必关闭SSL连接，否则会报错。关于如何关闭SSL连接，请参见[开启和关闭SSL连接](https://support.huaweicloud.com/usermanual-dds/dds_03_0074.html)。
  1. 登录弹性云服务器。
  
  2. 连接文档数据库实例。 
     **方式一：高可用连接（推荐）**
     DDS管理控制台界面提供了高可用连接地址。通过该地址连接副本集实例，不仅提升了数据读写性能，而且避免了在发生主备节点切换后，从客户端写入数据报错的问题。
     命令格式：
     **./mongo "** *\<内网高可用连接地址\>* **"**
     内网高可用连接地址：您可以在实例管理页面，单击目标实例名称，进入基本信息页面。单击"连接管理 \> 内网连接"，在"内网高可用连接地址"处即可获取到当前实例的连接地址。
     图5获取内网高可用地址   
     ![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000002353630425.png "点击放大")
     
     获取到的内网高可用地址格式如下，该连接地址采用固定的账号和数据库进行认证，即账号名**rwuser** 及认证数据库**admin**不可修改。
     **mongodb://rwuser:** *\<password\>* *@* *192.168.xx.xx:8635,192.168.xx.xx:8635* **/test?** **authSource=admin\&replicaSet=replica**
     您需要关注内网高可用地址中的如下参数：
     表4参数说明 
     | 参数名称                                    | 说明                                                                                                                                                                                                                                                                                                                                                                             |
     |:---|:---|
     | rwuser                                  | 账号名，即数据库账号。                                                                                                                                                                                                                                                                                                                                                                    |
     | *\<password\>*                          | 数据库账号对应的密码，需要替换为真实密码。 如果密码中包含特殊字符"@"、"!"、"$"、"%"和"+"需要分别替换为对应的十六进制的URL编码（ASCII码）"%40"、"%21"、"%24"、"%25"和"%2B"。 示例：密码为\*\*\*\*@%\*\*\*!$+，对应的URL编码为\*\*\*\*%40%25\*\*\*%21%24%2B。                                                                                                       |
     | *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=repli** **ca** **"**
     返回如下信息，表示实例已连接成功：
     ```
     replica:PRIMARY>
     ```
     执行如下命令，进入local库：
     **use loca** **l**
     回显信息如下：
     ```
     switched to db local
     ```
     执行如下命令，查询副本集oplog：
     **db.oplog.rs.find()**
     **方式二：内网高可用连接（用户自定义数据库及账号）**
     命令格式：
     **./mongo "** *\<内网高可用连接地址\>* **"**
     内网高可用连接地址：您可以在实例管理页面，单击目标实例名称，进入基本信息页面。单击"连接管理 \> 内网连接"，在"内网高可用连接地址"处即可获取到当前实例的连接地址。
     图6获取内网高可用地址   
     ![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000002319696062.png "点击放大")
     
     获取到的内网高可用地址格式如下：
     **mongodb://rwuser:** *\<password\>* *@* *192.168.xx.xx:8635,192.168.xx.xx:8635* **/test?** **authSource=admin\&replicaSet=replica**
     您需要关注内网高可用地址中的如下参数信息：
     表5参数信息 
     | 参数名称                                    | 说明                                                                                                                                                                                                                                                                                                                                                             |
     |:---|:---|
     | rwuser                                  | 数据库账号名，默认为"rwuser"。可根据实际情况修改为用户创建的账号名。                                                                                                                                                                                                                                                                                                                         |
     | *\<password\>*                          | 表示数据库账号对应的密码，需要替换为真实密码。 如果密码中包含特殊字符"@"、"!"、"$"、"%"和"+"需要分别替换为对应的十六进制的URL编码（ASCII码）"%40"、"%21"、"%24"、"%25"和"%2B"。 示例：密码为\*\*\*\*@%\*\*\*!$+，对应的URL编码为\*\*\*\*%40%25\*\*\*%21%24%2B。                                                                                                                       |
     | *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=repli** **ca** **"**
     **方式三：单个节点连接**
     您也可以通过单个主节点或备节点的内网IP地址访问副本集实例，该种方法在发生主备切换时，会影响数据的读写性能。
     命令格式：
     **./mongo --host** \<*DB_HOST* \>**--port** \<*DB_PORT* \>**-u** \<*DB_USER* \>**-p** **--authenticationDatabase** **admin**
     相关参数说明如下：
     表6参数说明 
     | 参数名称    | 说明                                                                                                                                                                                                                                                                                                                                                                                         |
     |:---|:---|
     | DB_HOST | 待连接实例主节点或备节点的内网IP地址。 主节点：即Primary节点，连接该节点后可执行数据的读写操作。 备节点：即Secondary节点，连接该节点后仅可执行数据的读操作。 您可以在实例管理页面，单击目标实例名称，进入基本信息页面。在"连接管理 \> 内网连接"页签下获取对应节点的IP地址。 图7获取节点IP地址 ![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000002581163940.png "点击放大")  |
     | DB_PORT | 数据库端口，默认为8635。 您可以单击目标实例名称，进入基本信息页面。在左侧导航树中单击连接管理，在内网连接页签，在"基本信息 \> 数据库端口"处获取实际端口号。 图8获取端口 ![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000002611523883.png "点击放大")                                                                                                                                     |
     | DB_USER | 数据库账号，默认为rwuser。                                                                                                                                                                                                                                                                                                                                                                           |
        
     连接命令示例：
     **./mongo --host** *192.168.xx.xx* **--port 8635 -u rwuser -p --authenticationDatabase admin**
     出现如下提示时，输入数据库账号对应的密码：
     ```
     Enter password:
     ```
     返回如下信息，表示对应的节点已经连接成功：
     - 针对副本集主节点的连接结果：
       ```
       replica:PRIMARY>
       ```
       
     
     - 针对副本集备节点的连接结果：
       ```
       replica:SECONDARY>
       ```
       
     
     
     
     
   
#### 相关文档
[DDS实例连接失败的排查思路](https://support.huaweicloud.com/dds_faq/dds_faq_0218.html)