通过Mongo Shell连接副本集实例（内网连接）

安装MongoDB客户端，请参见如何安装MongoDB客户端。

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

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

  

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

方式一：高可用连接（推荐）

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>

方式一：高可用连接（推荐）

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

命令格式：

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

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

图5 获取内网高可用地址

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

mongodb://rwuser:<password>@192.168.xx.xx:8635,192.168.xx.xx:8635/test?authSource=admin&replicaSet=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

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

例如用户自定义创建数据库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>