创建MongoClient

本页内容

概述

要连接到MongoDB部署，您需要两样东西

您还可以使用这两个组件之一来定制PyMongo在连接到MongoDB时的行为。

本指南向您展示了如何创建连接字符串并使用MongoClient对象连接到MongoDB。

标准的连接字符串包括以下组件

组件	描述
`mongodb://`	必需。一个前缀，用于标识这是一个标准连接格式的字符串。
`username:password`	可选。认证凭据。如果您包含这些凭据，客户端将使用在 `authSource` 中指定的数据库对用户进行认证。有关 `authSource` 连接选项的更多信息，请参阅认证机制。
`host[:port]`	必需。MongoDB 运行的主机和可选端口号。如果您不包括端口号，驱动程序将使用默认端口号 `27017`。
`/defaultauthdb`	可选。如果连接字符串包含 `username:password@` 认证凭据但未包含 `authSource` 选项，则使用的认证数据库。如果您不包含此组件，客户端将对 `admin` 数据库进行用户认证。
`?<options>`	可选。一个查询字符串，指定连接特定选项为 `<name>=<value>` 对。有关这些选项的完整描述，请参阅指定连接选项。

有关创建连接字符串的更多信息，请参阅连接字符串（在 MongoDB 服务器文档中）。

要创建到 MongoDB 的连接，将连接 URI 作为字符串传递给 MongoClient 构造函数。在以下示例中，驱动程序使用示例连接 URI 连接到本地主机 localhost 的端口 27017。

from pymongo import MongoClient
uri = "mongodb://localhost:27017/"
client = MongoClient(uri)

因为每个 MongoClient 对象代表到数据库的连接池，大多数应用程序只需要一个 MongoClient 实例，即使跨越多个请求。但是，如果您派生进程，子进程需要其自己的 MongoClient 对象。有关更多信息，请参阅常见问题解答页面。

要了解有关在 PyMongo 中创建 MongoClient 对象的更多信息，请参阅以下 API 文档