Docs 菜单
Docs 主页
/
语言
/
Python
/
pymongo
/
将数据写入 MongoDB

Delete Documents

在此页面上

  • Overview
  • 样本数据
  • 删除操作
  • 删除一个文档
  • 删除多个文档
  • 自定义删除操作
  • 返回值
  • API 文档

Overview

在本指南中，您可以了解如何使用 PyMongo 通过执行删除操作从 MongoDB 集合中删除文档。

删除操作可从 MongoDB 集合中删除一个或多个文档。 您可以使用 delete_one()或delete_many()方法执行删除操作。

样本数据

本指南中的示例使用 Atlas 样本数据集中的sample_restaurants.restaurants集合。要了解如何创建免费的 MongoDB Atlas 集群并加载样本数据集，请参阅 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 文档：

后退

替换文档