Docs 菜单
Docs 主页
/
MongoDB 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 集群。您还可以从“集群”视图添加数据库用户。

1
  1. 单击 Atlas 左上角的 Database

  2. Clusters(集群)视图中,单击要连接的集群的 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 集群。将示例中的占位符替换为您的档案和部署详细信息。

如果您在连接集群时遇到问题,请参阅解决连接问题。

提示

另请参阅:

← 连接到集群