本文档指导您如何通过 MongoDB Shell 或多种编程语言驱动，连接至腾讯云 MongoDB 实例。
连接方式简介
腾讯云 MongoDB 提供两种主要的连接方式：
MongoDB Shell：官方提供的交互式命令行工具，适用于数据库管理、查询和数据操作。
URI 连接串：标准的资源标识符，被所有官方驱动支持，适用于在应用程序代码中进行连接。
连接准备事项
连接串关键要素
1. 数据库访问地址与端口。
在 MongoDB 控制台 的实例列表，可获取访问数据库的内网地址。
在 MongoDB 控制台 的实例详情的网络配置区域，可获取数据库实例的访问地址。
2. 连接数据库的账户与密码。
默认用户：云数据库 MongoDB 内建了默认用户 mongouser
自定义用户：在 MongoDB 控制台 的数据库管理页面，可创建新的用户。具体操作，请参见账号管理。
3. 指定认证数据库。
云数据库 MongoDB 统一使用 admin 库作为登录鉴权的认证数据库，在 URI 中端口后面必须加上“/admin”以指定认证库，通过认证后再切换到具体业务数据库进行读写操作。
注意：
控制台创建的用户：认证库统一为 admin，连接时需指定 authSource=admin。
命令行创建的用户：认证库为其被创建时所在的数据库（例如在 test 库创建，则认证库为 test）。
认证机制：SCRAM-SHA-1 与 SCRAM-SHA-256 两种认证方式。
URI 连接串认证数据库示例如下所示，也可通过直接指定读写目标数据库和额外的认证库参数（authSource=admin）来直接访问目标数据库。
mongodb://username:password@IP:27017/adminmongodb://username:password@IP:27017/somedb?authSource=admin
4. 读操作的主从优先级。
在连接串，可通过参数 readPreference 控制读操作的路由节点。示例如下所示。
mongodb://username:password@IP:27017/admin?readPreference=secondaryPreferred
说明：
业务需要读写分离的时候更建议使用 secondaryPreferred，可用性更高。
如果有业务仅访问只读节点，建议配置两个或两个以上只读节点可实现读请求负载均衡，具有高可用保障。只读节点连接串可直接在实例详情页面的网络配置中获取。
取值 | 含义 |
primary | 只读主节点 |
primaryPreferred | 主节点优先，如主节点不可用，则读从节点/只读节点 |
secondary | 从节点/只读节点，如从节点不可用会报错 |
secondaryPreferred | 从节点/只读节点优先，如从节点/只读节点不可用，则读主节点 |
其他准备
1. 准备客户端环境，推荐申请与云数据库 MongoDB 实例在同一地域同一个 VPC 内的 Linux 云服务器 CVM。
2. 已 创建云数据库 MongoDB 实例，且状态为运行中。
3. 确认客户端环境与数据库实例网络互通。如果连接失败，请参见 无法连接 MongoDB 解决方法 逐一排查处理。更多问题，请参见 连接相关问题。
