创建MongoClient
概述
要连接到MongoDB部署,您需要以下两项
连接URI,也称为连接字符串,它告诉PyMongo要连接到哪个MongoDB部署。
MongoClient对象,它创建到MongoDB部署的连接并允许您对其进行操作。
您也可以使用这两个组件之一来自定义PyMongo在连接到MongoDB时的行为。
本指南将向您展示如何创建连接字符串并使用MongoClient
对象连接到MongoDB。
连接URI
标准的连接字符串包含以下组件
组件 | 描述 |
---|---|
mongodb:// | 必需。一个前缀,用于标识这是标准连接格式的字符串。 |
username:password | |
host[:port] | 必需。MongoDB运行的主机和可选端口号。如果您不包括端口号,则驱动程序使用默认端口 27017 。 |
/defaultauthdb | 可选。如果连接字符串包含 username:password@ 认证凭证但没有authSource 选项,则使用的认证数据库。如果您不包含此组件,则客户端将对admin 数据库进行用户认证。 |
?<options> | 可选。一个查询字符串,指定特定连接的选项,格式为 <name>=<value> 对。有关这些选项的完整描述,请参阅指定连接选项。 |
有关创建连接字符串的更多信息,请参阅连接字符串在MongoDB服务器文档中。
mongoClient
要创建与MongoDB的连接,请将连接URI作为字符串传递给mongoClient
构造函数。在以下示例中,驱动程序使用示例连接URI连接到本地主机localhost
上的27017
端口的MongoDB实例
from pymongo import MongoClient uri = "mongodb://localhost:27017/" client = MongoClient(uri)
提示
重用您的客户端
因为每个mongoClient
对象代表到数据库的连接池,大多数应用程序只需要一个mongoClient
实例,即使跨越多个请求。但是,如果您派生一个进程,子进程确实需要其自己的mongoClient
对象。有关更多信息,请参阅常见问题解答页面。
API文档
有关在PyMongo中创建mongoClient
对象的更多信息,请参阅以下API文档