Docs 菜单

Docs 主页开发应用程序Python 驱动程序pymongo

创建 MongoClient

在此页面上

  • Overview
  • 连接 URI
  • MongoClient
  • API 文档

要连接到 MongoDB 部署,您需要满足两个条件:

  • 连接 URI ,也称为连接string ,它告诉PyMongo要连接到哪个MongoDB部署。

  • 一个MongoClient对象,用于创建与 MongoDB 部署的连接并允许您对其执行操作。

您还可以使用这些组件来自定义 PyMongo 在连接到 MongoDB 时的行为方式。

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

标准连接string包括以下组件:

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

有关创建连接string 的更多信息,请参阅 MongoDB Server文档中的 连接字符串 。

要创建与MongoDB的连接,请将连接 URI 以string形式传递给 MongoClient 构造函数。 在以下示例中,驱动程序使用示例连接 URI 连接到localhost的端口27017上的 MongoDB 实例:

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

提示

重用客户端

由于每个MongoClient对象代表一个数据库连接池,因此大多数应用程序只需要一个MongoClient实例,即使在多个请求中也是如此。 但是,如果您派生进程,则子进程确实需要自己的MongoClient对象。 要了解更多信息,请参阅常见问题解答页面。

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

← 连接至 MongoDB