对于 AI 代理:可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。
Docs 菜单

通过客户端库连接到集群

集群的 Connect 对话框提供了通过使用MongoDB客户端库的应用程序连接到集群的详细信息。


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


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

有关包含您的MongoDB 服务器版本的设立功能的驱动程序版本列表,请查看您的驱动程序的客户端库兼容性表。

重要

官方支持的驱动程序

Use officially supported MongoDB drivers at current versions for the best reliability and support experience. The Atlas SLA covers officially supported drivers only.

Atlas 为 Community 驱动程序和已经停止使用的驱动程序版本提供尽力而为的仅诊断支持。Atlas 不测试、修补或认证 Community 驱动程序。支持可帮助您确定连接问题是源于平台还是驱动程序,但不调试驱动程序代码。

要了解更多信息,请参阅什么是 Atlas 对 Community 和不支持的驱动程序的支持策略?

您可以使用驱动程序和优化的连接字符串。连接到集群。

客户端必须支持 TLS 才能连接到 Atlas 集群。

Clients must support the SNI TLS extension to connect to an Atlas Free cluster (formerly known as M0) or Flex cluster.

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

To access a cluster, you must have a database user with access to the desired databases on your Atlas cluster. Database users are separate from Atlas users. Database users have access to MongoDB databases, while Atlas users have access to the Atlas application itself.

您可以在 Connect 对话框中创建数据库用户来访问 Atlas 集群。您还可以从 集群视图添加数据库用户。Atlas 在您创建第一个集群时创建了数据库用户。

1
  1. 如果尚未显示,请从导航栏上的 Organizations 菜单中选择包含所需项目的组织。

  2. 如果尚未显示,请从导航栏的Projects菜单中选择所需的项目。

  3. 在侧边栏中,单击 Database 标题下的 Clusters。

会显示集群页面。

2

单击要连接的集群所对应的 Connect。

3

Choose Connection Type 。

注意

启用功能时显示的选项

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

将此连接类型用于允许的公共 IP 地址。

4

Add a Connection IP Address

重要

如果 Atlas 在 Setup connection security 步骤中指示您已经在集群中配置了 IP 访问列表条目,请跳过此步骤。要管理 IP 访问列表,请参阅向访问列表添加条目。

Atlas 支持标准客户端从项目的 IP 访问列表中的条目连接到集群。项目 IP 访问列表与 API 访问列表不同,后者将 API 访问权限限制为特定的 IP 或 CIDR 地址。

如果 IP 访问列表为空,Atlas 会提示您将 IP 地址添加到项目的 IP 访问列表中。您可以执行以下任一操作:

  • 单击 Add Your Current IP Address 以允许从当前 IP 地址进行访问。

  • 单击 Add an IP Address 添加单个 IP 地址或带有 CIDR 标记的地址范围。

为新添加的 IP 地址或 CIDR 范围提供可选说明。单击 Add IP Address 将地址添加到 IP 访问列表。

5

重要

如果 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(选择连接方法)。

6

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

7

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

Use this connection string in your application 下,连接字符串默认使用 SRV 格式 (mongodb+srv://)。要查看标准(非 SRV)连接字符串 (mongodb://),关闭 SRV Connection String 开关。

注意

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

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

In the following example, you authenticate and connect to an Atlas cluster by using a URI connection string. Replace the placeholders in the example with your credentials and deployment details.

注意

要连接到 Atlas M0 免费集群或 Flex 集群,您必须使用支持 MongoDB 7.0 及更高版本的 C 驱动程序版本。有关 C 驱动程序与 MongoDB 之间兼容性的完整文档,请参阅 MongoDB 兼容性矩阵。我们建议您升级到最新版本的驱动程序。

client = mongoc_client_new ("mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority");
db = mongoc_client_get_database (client, "<databaseName>");
MongoDB 版本
推荐的驱动程序版本

所有

See the MongoDB compatibility matrix for the latest recommended driver versions.

MongoDB 7.0及更高版本

1.11 及更高版本

注意

以下配置选项仅适用于以单线程模式运行 C 驱动程序的情况。

MongoDB 驱动程序在集群选举或故障转移事件后自动尝试选择服务器。默认情况下,如果 C 驱动程序第一次尝试选择服务器失败,则会立即引发错误。以下配置设置可提高应用程序与 Atlas 集群的连接性,但会在服务器选择循环中花费更多时间:

  • Set serverSelectionTryOnce to false to direct the C driver to perform server selection up to the time limit defined by serverSelectionTimeoutMS.

  • Lower the serverSelectionTimeoutMS to 15000 from the default of 30000. MongoDB elections typically take 10 seconds, but can be as fast as 5 seconds on Atlas. Setting this value to 15 seconds (15000 milliseconds) covers the upper bound of election plus additional time for latency.

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