Docs 菜单

Docs 主页启动和管理 MongoDBMongoDB Atlas

通过驱动程序连接

在此页面上

  • 先决条件
  • 连接您的应用程序
  • 驱动程序示例
  • 故障排除

数据库部署的 Connect对话框提供了通过使用 MongoDB 驱动程序的应用程序连接到数据库部署的详细信息。

注意

无服务器实例目前不支持通过某些驱动程序或驱动程序版本进行连接。要了解详情,请参阅无服务器实例限制


➤ 使用 Select your language(选择您的语言)下拉菜单设置此页面上示例的语言。


驱动程序版本必须与 MongoDB Server 版本兼容。我们建议你选择与 MongoDB Server 版本兼容的最新驱动程序,以使用最新的数据库功能并为将来的版本升级做好准备。

有关包含您的 MongoDB Server 版本的全套功能的驱动程序版本列表,请检查您的MongoDB 驱动程序的兼容性矩阵。

有关可用于连接无服务器实例的驱动程序版本的列表,请参阅无服务器实例的最低驱动程序版本

要使用驱动程序和优化的连接字符串连接到分片集群,您必须至少使用以下驱动程序版本之一:

驱动
版本
C
1.19.0
3.7.0beta1
2.13.0
1.6.0
4.3.0
4.10.0
2.5.0
4.1.0
1.11.0(扩展)
1.10.0(库)
3.12.0
2.16.0
2.1.0
4.3.0
1.2.0

客户端必须支持 TLS 才能连接到 Atlas 数据库部署。

客户端必须支持 SNI 用于连接到 AtlasM0 免费集群或M2/M5 共享集群的 TLS 扩展。要验证 MongoDB 驱动程序 是否支持 SNI TLS 扩展,请参阅驱动程序文档的兼容性部分。如果驱动程序与 MongoDB4 兼容。2 及更高版本,支持 SNI TLS 扩展。

要访问数据库部署,您必须从 Atlas 项目的 IP 访问列表上的 IP 地址进行连接。如需在 IP 访问列表中添加 IP 地址,您可以在 Connect 对话框中执行此操作。您也可以通过网络访问标签页添加 IP 地址。

要访问数据库部署,您必须在 Atlas 数据库部署上创建一个有权访问所需数据库的数据库用户。数据库用户与 Atlas 用户是分开的。数据库用户可以访问 MongoDB 数据库,而 Atlas 用户可以访问 Atlas 应用程序本身。

您可以在 Connect(连接)对话框中创建一个数据库用户来访问 Atlas 数据库部署。您还可从“Database Deployment”(数据库部署)视图添加数据库用户。

1
  1. 单击 Atlas 左上角的 Database

  2. Database Deployments(数据库部署)视图中,单击要连接到的数据库部署的 Connect(连接)。

2

Choose Connection Type

注意

启用功能时显示的选项

Atlas 显示连接类型选项(在启用对等互连的私有 IP私有端点或两者后)。如果您尚未启用任一功能,则不会显示任何按钮,并且连接类型默认为标准

3
4

重要

如果 Atlas 在 Setup connection security(设置连接安全)步骤中指示项目中至少已配置一个数据库用户,请跳过此步骤。如要管理现有数据库用户,请参阅配置数据库用户

要访问数据库部署,您需要有一个可以访问项目数据库部署所需数据库的 MongoDB 用户。如果您的项目没有 MongoDB 用户,Atlas 会提示您创建一个具有 Atlas Admin 角色的新用户。

  1. 输入新用户的 Username(用户名)。

  2. 输入此新用户的 Password(密码)或单击 Autogenerate Secure Password(自动生成安全密码)。

  3. 单击 Create Database User(创建数据库用户)以保存此用户。

在以下步骤中,使用此用户连接数据库部署。

将 IP 地址添加到 IP 访问列表并添加数据库用户后,单击 Choose Your Connection Method(选择连接方法)。

5

Choose a connection method(选择连接方法)步骤中,选择Drivers(连接应用程序)。

6

从下拉菜单中选择您的驱动程序和版本。显示包含连接字符串的代码示例。将 <password> 替换为您创建数据库用户时指定的密码。

注意

如果您的密码、数据库名称或连接字符串包含保留的 URI 字符,则必须对这些字符进行转义。例如,如果您的密码是 @bc123,则在连接字符串中指定密码时必须对 @ 字符进行转义,例如 %40bc123。要了解详情,请参阅连接字符串密码中的特殊字符

要了解更多信息,请参阅驱动程序兼容性。

在以下示例中,您使用URI 连接字符串进行身份验证并连接到 Atlas 数据库部署。将示例中的占位符替换为您的档案和部署详细信息。

如果在连接到数据库部署时遇到问题,请参阅解决连接问题

提示

另请参阅:

← 连接到数据库部署