tencent cloud

云数据库 MongoDB

通过 URI 连接串连接

Download
Focus Mode
Font Size
Last updated: 2026-07-09 15:11:10
本方法适用于在应用程序代码中使用各种编程语言驱动进行连接 MongoDB 实例。

获取标准 URI 连接串

1. 登录 MongoDB 控制台。
2. 在实例列表中找到目标实例。
3. 进入实例详情页,在网络配置区域的访问地址中,复制完整的连接串,如下图所示。

关键连接参数详解,请参见下表。更多内容,请参见 MongoDB 官网文档。
参数
含义
是否必须
备注
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=secondaryPreferred
primary:(默认)所有读请求只发往主节点。
primaryPreferred:主节点优先,如主节点不可用,则读从节点/只读节点。
secondary:从节点/只读节点,如从节点不可用会报错。
secondaryPreferred:从节点/只读节点优先,如从节点/只读节点不可用,则读主节点。

多语言连接示例

您可以使用此连接串,配合不同语言的 MongoDB 驱动进行连接。
驱动下载:请使用最新版的客户端驱动以保证最好的兼容性,包括 Shell 套件、Java jar 包、PHP 扩展、Node.js 模块等,具体请参见 MongoDB 官网驱动介绍。
不同语言连接示例。

常见问题

如果连接失败,请参见 无法连接 MongoDB 解决方法 逐一排查处理。更多问题,请参见 连接相关问题。

Help and Support

Was this page helpful?

Help us improve! Rate your documentation experience in 5 mins.

Feedback