pymongo

简介

欢迎访问 PyMongo 文档站点，PyMongo 是同步 Python 应用程序的官方 MongoDB 驱动程序。使用 pip 下载 或者按照我们的教程设置可运行的项目。

• 教程 关于如何连接到 MongoDB 并运行常见操作的教程。

• API 参考

• 变更日志

• 源代码

您可以使用 PyMongo 驱动程序连接到以下环境中托管的部署：

• MongoDB Atlas ：用于在云中部署 MongoDB 的完全托管服务

• MongoDB Enterprise ：基于订阅、自我管理的 MongoDB 版本

• MongoDB Community ：提供源代码、免费使用且可自行管理的 MongoDB 版本

参加 MongoDB 举办的免费在线课程

	将 MongoDB 与 Python 结合使用 了解使用 MongoDB 进行 Python 应用程序开发的基础知识。

安装

您必须安装 PyMongo 驱动程序模块才能使其可供 Python 应用程序使用。我们建议使用 pip 安装 PyMongo。

PyMongo 需要 dnsPython 以支持mongodb+srv:// 连接字符串和 MongoDB Atlas dnspython。安装或升级到最新 PyMongo 版本时会自动安装 。

以下命令演示了如何使用命令行安装最新版本的模块：

$ python -m pip install pymongo

如要安装特定版本的 PyMongo，请在命令中指定版本。以下命令显示如何使用 pip 安装 PyMongo 版本 3.11：

$ python -m pip install pymongo==3.11

如果已安装 PyMongo 并需要升级到最新版本，请使用以下 pip 命令：

$ python -m pip install --upgrade pymongo

请参阅 “安装” 了解安装 PyMongo 的更多方法。

连接到 MongoDB Atlas

您可以使用以下连接片段来测试与 Atlas 上 MongoDB 部署的连接：

from pymongo.mongo_client import MongoClient
from pymongo.server_api import ServerApi
# Replace the placeholder with your Atlas connection string
uri = "<connection string>"
# Set the Stable API version when creating a new client
client = MongoClient(uri, server_api=ServerApi('1'))
                          
# Send a ping to confirm a successful connection
try:
    client.admin.command('ping')
    print("Pinged your deployment. You successfully connected to MongoDB!")
except Exception as e:
    print(e)

此连接代码段使用 Stable API 功能，您可以在使用 PyMongo 驱动程序 v3.12 （或更高版本）连接到 MongoDB Server v5.0 （或更高版本）时启用此功能。使用此功能时，您可以放心更新驱动程序或服务器，无需担心任何 Stable API 所支持的命令的向后兼容性问题。

要了解有关 Stable API 功能的更多信息，请参阅服务器手册中的Stable API 。

在没有 Stable API 的情况下连接到 MongoDB Atlas

如果您使用的 MongoDB 版本或驱动程序不支持“稳定 API”功能，您可以使用以下代码片段来测试与 Atlas 上的 MongoDB 部署的连接：

from pymongo.mongo_client import MongoClient
# Replace the placeholder with your Atlas connection string
uri = "<connection string>"
# Create a new client and connect to the server
client = MongoClient(uri)
# Send a ping to confirm a successful connection
try:
    client.admin.command('ping')
    print("Pinged your deployment. You successfully connected to MongoDB!")
except Exception as e:
    print(e)

从 AWS Lambda 连接到 MongoDB Atlas

要了解如何从 AWS Lambda 连接到 Atlas，请参阅使用 AWS Lambda 管理连接文档。

连接到本地计算机上的 MongoDB Server

如果您需在本地机器上运行 MongoDB 服务器以用于开发目的而不是使用 Atlas 集群，则需完成以下操作：

1. 下载Community或Enterprise版本的 MongoDB Server。

2. 安装和配置MongoDB Server。

3. 启动该服务器。

在成功启动 MongoDB 服务器后，在驱动程序连接代码中指定连接字符串。

如果 MongoDB Server 在本地运行，您可以使用连接字符串 "mongodb://localhost:<port>"，其中 <port> 是您配置服务器以侦听传入连接的端口号。

如果需要指定不同的主机名或 IP 地址，请参阅我们的《服务器手册》中有关连接字符串的条目。

要测试是否可以连接到服务器，请替换“连接到 MongoDB Atlas”代码示例中的连接字符串并运行。

兼容性