Docs 主页 → 开发应用程序 → Python 驱动程序 → pymongo
Delete Documents
Overview
在本指南中，您可以了解如何使用 PyMongo 通过执行删除操作从 MongoDB 集合中删除文档。
删除操作可从 MongoDB 集合中删除一个或多个文档。 您可以使用 delete_one()或delete_many()方法执行删除操作。
样本数据
本指南中的示例使用 Atlas 样本数据集中的sample_restaurants.restaurants集合。 要了解如何创建免费的MongoDB Atlas cluster并加载样本数据集，请参阅PyMongo入门教程。
删除操作
您可以使用以下方法在 MongoDB 中执行删除操作：
delete_one()，这会删除与 Atlas Search条件匹配的 第一个文档delete_many()，这会删除与 Atlas Search条件匹配的 所有文档
每种删除方法都需要一个查询筛选器文档，其中指定了Atlas Search标准，以确定选择要删除的文档。 有关查询筛选器的更多信息，请参阅 MongoDB Server 手册中的查询筛选器文档部分。
删除一个文档
以下示例使用delete_one()方法删除restaurants集合中name值为"Ready Penny Inn"的文档：
query_filter = { "name": "Ready Penny Inn" } result = restaurants.delete_one(query_filter)
删除多个文档
以下示例使用delete_many()方法删除restaurants集合中borough值为"Brooklyn"的所有文档：
query_filter = { "borough": "Brooklyn" } result = restaurants.delete_many(query_filter)
自定义删除操作
delete_one()和delete_many()方法可以选择接受其他参数，这些参数表示可用于配置删除操作的选项。 如果不指定任何其他选项，驱动程序不会自定义删除操作。
属性 | 说明 |
|---|---|
collation | Specifies the kind of language collation to use when sorting
results. For more information, see Collation
in the MongoDB Server manual. |
hint | Gets or sets the index to scan for documents.
For more information, see the hint statement
in the MongoDB Server manual. |
session | An instance of ClientSession. |
let | A map of parameter names and values. Values must be constant or closed
expressions that don't reference document fields. For more information,
see the let statement in the
MongoDB Server manual. |
comment | A comment to attach to the operation. For more information, see the delete command
fields guide in the
MongoDB Server manual for more information. |
以下代码使用 delete_many() 方法删除 restaurants 集合中 name 值包含string "Mongo" 的所有文档。 它还使用comment选项为操作添加注释：
query_filter = { 'name': {'$regex': 'Mongo' }} result = restaurants.delete_many(query_filter, comment="Deleting Mongo restaurants")
提示
如果前面的示例使用的是delete_one()方法而不是delete_many() ，则驱动程序将仅删除name值包含"Mongo"的第一个文档。
返回值
delete_one()和delete_many()方法返回DeleteResult类型。 该类型包含以下属性：
deleted_count，表示已删除的文档数acknowledged，表示服务器是否确认结果raw_result，即服务器返回的原始结果
注意
如果acknowledged 属性为False ，则 的所有其他属性在访问时都会引发DeleteResult InvalidOperation异常。如果服务器未确认写入操作，则驱动程序无法确定这些值。
如果查询筛选器与任何文档都不匹配，则驱动程序不会删除任何文档，并且deleted_count为0 。
API 文档
要进一步了解本指南所讨论的任何方法或类型，请参阅以下 API 文档：