分片集群实例连接说明

MongoDB分片集群实例分别提供Mongos、ShardConfigServer组件单独的连接地址,以及适用于应用程序连接的高可用ConnectionStringURI地址。本文介绍分片集群实例连接地址的获取方式和连接说明。

获取数据库连接地址

  1. 访问MongoDB分片集群实例列表,在上方选择资源组和地域,然后单击目标实例ID。

  2. 在目标实例页面的左侧导航栏,单击数据库连接获取目标节点的连接地址。

连接地址说明

连接地址网络类型

网络类型

说明

私网

  • 专有网络:专有网络是具备更高安全性和性能的一种隔离网络。云数据库MongoDB实例默认提供专有网络连接地址。

  • 经典网络:非隔离网络,仅依靠云服务的安全组或白名单策略进行防护。新购实例不再支持经典网络,请参见【通知】云数据库MongoDB新购买实例不再支持经典网络

公网

由于通过公网连接实例存在一定的安全风险,云数据库MongoDB实例默认未提供公网连接地址。如果您需要公网连接可手动申请,申请方法请参见(可选)申请公网连接地址

连接地址类型

地址类型

说明

Mongos地址

Mongos组件的连接地址,包括主节点(Primary)的连接地址。

说明

日常测试时,仅需连接Mongos组件的任意节点。

Shard地址

Shard组件的连接地址,包括主节点(Primary)、从节点(Secondary)和只读节点(ReadOnly)的连接地址。

说明
  • 默认情况下,控制台仅会展示Mongos的连接地址,ShardConfigServer的连接地址需要先申请对应节点的连接地址,如何申请,请参见申请ShardConfigServer节点连接地址

  • 只有Shard组件中存在只读节点时,您才能看到Shard组件的只读节点连接地址。

ConfigServer地址

ConfigServer组件的连接地址,包括主节点(Primary)和从节点(Secondary)的连接地址。

说明
  • 默认情况下,控制台仅会展示Mongos的连接地址,ShardConfigServer的连接地址需要先申请对应节点的连接地址,如何申请,请参见申请ShardConfigServer节点连接地址

  • 仅本地盘版分片集群实例支持申请ConfigServer的连接地址。

ConnectionstringURI地址

云数据库 MongoDB 版提供了Mongos组件和Shard组件的ConnectionStringURI地址。

推荐生产环境的应用程序通过ConnectionStringURI连接数据库,客户端自动将请求发送到Mongos组件的多个节点上,实现负载均衡。Mongos组件的某个节点出现故障时,客户端能自动进行故障切换,将请求发送到状态正常的Mongos节点上。

说明

默认情况下,控制台仅会展示MongosConnectionStringURI地址,ShardConnectionStringURI地址需要先申请对应节点的连接地址,如何申请,请参见申请Shard连接地址

ConnectionstringURI SRV地址

SRV地址可以简化集群的维护和管理,您无需因为增删Mongos节点而修改连接地址,客户端可以无感知地与集群交互,简化了应用程序的设计和维护。

推荐生产环境的应用程序通过ConnectionStringURI连接数据库,客户端自动将请求发送到Mongos组件的多个节点上,实现负载均衡。Mongos组件的某个节点出现故障时,客户端能自动进行故障切换,将请求发送到状态正常的Mongos节点上。

重要
  • 默认情况下控制台不显示SRV地址,如需使用请单击数据库连接页面的申请私网SRV地址申请公网SRV地址

  • 申请公网SRV地址前,您需要先开通Mongos节点的公网地址。通过公网SRV地址连接MongoDB实例后,客户端会自动将请求发送到已开通公网地址的Mongos节点上。

  • SRV地址仅支持云盘版实例。

  • 专有网络的私网SRV地址最多关联20Mongos节点,因专有网络内DNS解析协议的限制,在超出20Mongos节点的情况下,超出的节点将不能分担请求负载。公网SRV地址不受此限制。

各连接地址的格式、参数说明以及示例如下:

Mongos地址

格式:

<host>:<port>

参数说明:

参数

说明

<host>

Mongos组件中节点的域名信息

<port>

Mongos组件中节点的端口

示例:

s-bp1c010266f6****.mongodb.rds.aliyuncs.com:3717

Shard地址

格式:

<host>:<port>

参数说明:

参数

说明

<host>

Shard组件中节点的域名信息

<port>

Shard组件中节点的端口

示例:

s-bp1c010266f6****.mongodb.rds.aliyuncs.com:3717

ConfigServer地址

格式:

<host>:<port>

参数说明:

参数

说明

<host>

ConfigServer组件中节点的域名信息

<port>

ConfigServer组件中节点的端口

示例:

s-bp1c010266f6****.mongodb.rds.aliyuncs.com:3717

ConnectionstringURI地址

Mongos组件和Shard组件的ConnectionStringURI地址的说明分别如下:

Mongos

重要

推荐生产环境的应用程序通过ConnectionStringURI连接数据库,客户端自动将请求发送到Mongos组件的多个节点上,实现负载均衡。Mongos组件的某个节点出现故障时,客户端能自动进行故障切换,将请求发送到状态正常的Mongos节点上。

格式:

mongodb://<username>:<password>@<host1>:<port1>,<host2>:<port2>,...,<hostN>:<portN>/<database>[?&authSource=<authenticationDatabase>]

参数

说明

<username>

数据库账号的名称,默认为root。

<password>

数据库账号的密码。

<host>

Mongos组件中节点的域名信息

<port>

Mongos组件中节点的端口

<database>

要访问的数据库名称,默认为admin。

authSource=<authenticationDatabase>(可选)

该参数用于指定数据库账号所属的数据库。<authenticationDatabase>为鉴权数据库名称。如果不配置该参数,<database>会作为鉴权数据库。

示例:

数据库账号为test,所属数据库为admin。

mongodb://test:****@s-bp1c010266f6****.mongodb.rds.aliyuncs.com:3717,s-bp1773180e38****.mongodb.rds.aliyuncs.com:3717/admin

Shard

Shard组件的ConnectionStringURI地址为高可用地址,实现负载均衡及高可用,连接该地址可以执行数据库的读写操作。该地址包含Shard组件中所有节点的地址,建议生产环境的应用程序通过该地址连接实例。

重要

生产环境的应用程序建议通过ConnectionStringURI地址连接实例,可以确保连接的节点始终为主节点,不会因为主备切换而影响应用的读写操作。

格式:

mongodb://<username>:<password>@<host1>:<port1>,<host2>:<port2>,...,<hostN>:<portN>/<database>?replicaSet=<replicaSet_value>[&authSource=<authenticationDatabase>]

参数说明:

参数

说明

<username>

数据库账号的名称,默认为root。

<password>

数据库账号的密码。

<host>

主节点、从节点和只读节点的域名信息

<port>

主节点、从节点和只读节点的端口

<database>

要访问的数据库名称,默认为admin。

replicaSet=<replicaSet_value>

该参数可以将读请求发送到副本集实例的所有节点。<replicaSet_value>为实例高可用连接地址的唯一标识ID。

authSource=<authenticationDatabase>(可选)

该参数用于指定数据库账号所属的数据库。<authenticationDatabase>为鉴权数据库名称。如果不配置该参数,<database>会作为鉴权数据库。

readPreference=[primary | primaryPreferred | secondary | secondaryPreferred](可选)

该参数可以实现读写分离和负载均衡,能够将写请求发送到主节点,将读请求发送到参数指定节点,取值说明如下:

  • readPreference=primary:读请求仅发送到主节点。

  • readPreference=primaryPreferred:读请求优先发送到主节点。如果主节点故障,将读请求发送到从节点和只读节点。

  • readPreference=secondary:读请求仅发送到从节点和只读节点。如果从节点和只读节点都出现故障,读请求失败,不会发送到主节点。

  • readPreference=secondaryPreferred:读请求优先发送到从节点和只读节点。如果从节点和只读节点都出现故障,该参数将读请求发送到主节点。

说明

当读请求发送到从节点和只读节点时,可能会出现负载不均的情况,如果需要进一步指定节点,请设置参数readPreferenceTags。

readPreferenceTags=<readonly_Tags>(可选)

该参数可以将读请求优先发送到标签对应的节点。通常与参数readPreference一起使用,与primary模式不兼容。<readonly_Tags>为只读节点的标签键值对列表,支持的类型如下:

  • readPreferenceTags=role:electable:优先读从节点。

    说明

    该选项仅对云盘版实例生效。

  • readPreferenceTags=role:readonly:优先读只读节点。

MongoDB实例可以灵活使用readPreferencereadPreferenceTags参数,通过不同标签的组合,实现不同的场景需求:

读请求主节点响应策略

读请求发送的节点

参数组合方案

读请求失败情况下,读请求发送到主节点

优先读主节点

readPreference=primaryPreferred

优先读从节点和只读节点

readPreference=secondaryPreferred

优先读从节点

说明

如果从节点故障,读请求发送到主节点。

readPreference=secondaryPreferred&readPreferenceTags=role:electable

优先读只读节点

说明

如果只读节点故障,读请求发送到主节点。

readPreference=secondaryPreferred&readPreferenceTags=role:readonly

读请求失败情况下,读请求不发送到主节点

仅读从节点和只读节点

readPreference=secondary

仅读从节点

说明

如果从节点故障,读取操作失败。

readPreference=secondary&readPreferenceTags=role:electable

仅读只读节点

说明

如果只读节点故障,读取操作失败。

readPreference=secondary&readPreferenceTags=role:readonly

示例:

mongodb://test:****@dds-bp19f409d7512****.mongodb.rds.aliyuncs.com:3717,dds-bp19f409d7512****.mongodb.rds.aliyuncs.com:3717/admin?replicaSet=mgset-6108****

ConnectionstringURI SRV地址

格式:

mongodb+srv://<username>:<password>@<srv-host>/<database>?<options>

参数说明:

参数

说明

mongodb+srv://

连接字符串的前缀,表示使用DNS SRV记录进行服务发现。

<username>

数据库账号的名称,默认为root。

<password>

数据库账号的密码。

<srv-host>

主机名。

<database>

要访问的数据库名称,默认为admin。

<option>

其他可选参数。

说明

SVR连接的SSL选项默认值为true,如果您不需要使用SSL加密连接,需要在连接串上添加参数ssl=false。更多可选参数的介绍,请参见MongoDB官网文档

示例:

数据库账号为test,所属数据库为admin。

mongodb+srv://test:****@dds-2zef4c23****-srv.mongodb.pre.nosql.aliyuncs.com/admin?ssl=false

登录MongoDB数据库

  1. 获取如下信息:

    • 数据库连接地址,获取方法请参见数据库连接地址

    • 数据库账号,初始账号为root。

      重要

      不建议在生产环境中直接使用root账号连接数据库。您可以根据业务需求创建用户并分配权限,详情请参见使用DMS管理MongoDB数据库用户

    • 数据库账号对应密码。如果没有设置或忘记密码,您可以设置或修改密码,具体方法请参见重置密码

    • 要访问的数据库。当数据库账号为root时,对应的数据库为admin。

  2. 登录数据库。您可以选择以下任意一种方法登录:

常见的连接场景

相关问题