本方法适用于在应用程序代码中使用各种编程语言驱动进行连接 MongoDB 实例。
获取标准 URI 连接串
1. 登录 MongoDB 控制台。
2. 在实例列表中找到目标实例。
3. 进入实例详情页,在网络配置区域的访问地址中,复制完整的连接串,如下图所示。

参数 | 含义 | 是否必须 | 备注 |
mongodb:// | MongoDB 协议标识符 | 是 | - |
username:password | 数据库认证信息 | 是 | 默认用户:云数据库 MongoDB 内建了默认用户 mongouser 自定义用户:在 MongoDB 控制台 的数据库管理页面,可创建新的用户。具体操作,请参见 账号管理。 |
host:port | 实例节点地址 | 是 | 支持多个地址,用逗号分隔。 |
/admin 或 authSource=admin | 认证数据库 | 是 | 控制台创建的用户:认证库统一为 admin,连接时需指定 authSource=admin。 命令行创建的用户:认证库为其被创建时所在的数据库(例如在 test 库创建,则认证库为 test)。 |
replicaSet | 副本集 ID | 是 | 标识实例的副本集名称。 |
authMechanism=SCRAM-SHA-1 | 认证机制 | 否 | 认证机制:SCRAM-SHA-1 与 SCRAM-SHA-256 两种认证方式。 |
readPreference | 读偏好设置 | 否 | 控制读请求的路由。例如: mongodb://.../admin?readPreference=secondaryPreferredprimary:(默认)所有读请求只发往主节点。 primaryPreferred:主节点优先,如主节点不可用,则读从节点/只读节点。 secondary:从节点/只读节点,如从节点不可用会报错。 secondaryPreferred:从节点/只读节点优先,如从节点/只读节点不可用,则读主节点。 |
多语言连接示例
您可以使用此连接串,配合不同语言的 MongoDB 驱动进行连接。
驱动下载:请使用最新版的客户端驱动以保证最好的兼容性,包括 Shell 套件、Java jar 包、PHP 扩展、Node.js 模块等,具体请参见 MongoDB 官网驱动介绍。
不同语言连接示例。
PHP 连接示例
Go 连接示例
PHP 重连机制