连接指南

连接 URI

连接 URI 是驱动程序用来连接 MongoDB 部署的指令集。该指令集指示驱动程序应如何连接到 MongoDB，以及在连接时应如何运行。下面的示例显示了连接 URI 的各个部分：

在此示例中，我们连接到具有 DNS SRV 记录的 Atlas MongoDB 部署。有关详细信息，请参阅DNS 种子列表连接格式文档。这种格式提供了部署灵活性，并且能够轮流更改服务器而无需重新配置客户端。

如果您要连接到没有 DNS SRV 地址的实例或副本集，则必须为协议使用 mongodb，该协议指定了标准连接字符串格式。

在协议之后，如果使用基于密码的身份验证，连接字符串的下一部分包含档案。将 user 的值替换为您的用户名，将 pass 替换为您的密码。如果使用的是不需要用户名和密码的身份验证机制，请省略连接 URI 中的这一部分。

连接字符串的下一部分指定 MongoDB 实例的主机名或 IP 地址，后跟端口号。在上面的示例中，我们使用 sample.host 作为主机名，使用 27017 作为端口。将这些值替换为您的 MongoDB 实例。

连接字符串的最后一部分包含作为参数的连接和身份验证选项。在上面的示例中，我们设置了两个连接选项： maxPoolSize=20和w=majority 。有关连接选项的更多信息，请跳至连接选项部分。

Atlas 连接示例

您必须创建一个客户端来连接到 Atlas 上的 MongoDB 部署。要创建客户端，请构造一个 MongoClient 实例，并传入 URI 和 MongoClientOptions 对象。

使用 MongoClientOptions 对象中的 serverApi 选项可启用 Stable API 功能，这会强制服务器运行其中行为与指定 API 版本兼容的操作。

以下代码展示了在连接到 Atlas 上的 MongoDB 部署时，如何指定连接字符串和 Stable API 客户端选项，并检查连接是否成功：

const { MongoClient, ServerApiVersion } = require("mongodb");
// Replace the placeholder with your Atlas connection string
const uri = "<connection string>";
// Create a MongoClient with a MongoClientOptions object to set the Stable API version
const client = new MongoClient(uri,  {
        serverApi: {
            version: ServerApiVersion.v1,
            strict: true,
            deprecationErrors: true,
        }
    }
);
async function run() {
  try {
    // Connect the client to the server (optional starting in v4.7)
    await client.connect();
    // Send a ping to confirm a successful connection
    await client.db("admin").command({ ping: 1 });
    console.log("Pinged your deployment. You successfully connected to MongoDB!");
  } finally {
    // Ensures that the client will close when you finish/error
    await client.close();
  }
}
run().catch(console.dir);

要了解有关 Stable API 功能的更多信息，请参阅 Stable API 页面。

连接 MongoDB 的其他方式

如果要连接到未托管在 Atlas 上的单个 MongoDB 服务器实例或副本集，请参阅以下部分了解如何连接。

mongodb://localhost:<port>

mongodb://host1:27017,host2:27017,host3:27017/?replicaSet=myRs