定义
db.collection.deleteMany()带驱动程序的 MongoDB
本页面文档 mongosh 方法。要查看 MongoDB 驱动程序中的等效方法，请参阅您的编程语言的相应页面：从集合中删除与
filter匹配的所有文档。返回： 文档包含以下内容：
如果操作使用写关注来运行，则布尔值
acknowledged为true；如果已禁用写关注，则为falsedeletedCount包含已删除文档的数量
注意
如果要删除大型集合中的所有文档，则删除该集合并重新创建可能速度更快。在删除集合之前，请记下集合上的所有索引。您必须重新创建原始集合中存在的任何索引。如果原始集合是分片的，则对重新创建的集合也要分片。
有关删除集合的更多信息，请参阅 db.collection.drop()。
兼容性
此方法可用于以下环境中托管的部署：
- MongoDB Atlas：用于云中 MongoDB 部署的完全托管服务
注意
所有 MongoDB Atlas 集群都支持此命令。有关 Atlas 对所有命令的支持的信息，请参阅不支持的命令。
MongoDB Enterprise：基于订阅、自我管理的 MongoDB 版本
MongoDB Community：源代码可用、免费使用且可自行管理的 MongoDB 版本
语法
db.collection.deleteMany() 通过以下语法实现：
db.collection.deleteMany( <filter>, { writeConcern: <document>, collation: <document>, hint: <document>|<string>, maxTimeMS: <int>, let: <document> })Parameter | 类型 | 说明 |
|---|---|---|
文档 | 使用查询运算符指定删除条件。 要删除集合中的所有文档，请传入空文档 ( | |
文档 | ||
文档 | 可选。 可选。指定用于操作的排序规则。 排序规则允许用户为字符串比较指定特定于语言的规则，例如字母大小写和重音符号规则。 排序规则选项的语法如下： 指定排序规则时， 如果未指定排序规则，但集合具有默认排序规则（请参阅 如果没有为收集或操作指定排序规则，MongoDB 将使用先前版本中使用的简单二进制比较来进行字符串比较。 您不能为一个操作指定多个排序规则。例如，您不能为每个字段指定不同的排序规则，或者如果执行带排序的查找，则不能使用一种排序规则进行查找而另一种排序规则进行排序。 | |
文档 | ||
整型 | 可选。指定删除操作在超时之前运行的时间限制（以毫秒为单位）。 | |
文档 | 可选。 指定包含变量列表的文档。这样可以将变量与查询文本分开，从而提高命令的可读性。 文档语法为： 变量设置为表达式返回的值，并且之后不能再进行更改。 要访问命令中的变量值，请使用双美元符号前缀 ( 要使用变量筛选结果，您必须在 有关使用 |
行为
分片集合
如果
deleteMany()在事务之外运行，针对多个分片的操作会将该操作广播到集群中的所有分片。如果
deleteMany()在ACID 事务中运行，则针对多个分片的操作仅针对相关分片。
警告
由于存在并发数据块迁移，deleteMany()运行可能不会删除与指定过滤匹配的所有文档。为确保删除所有匹配的文档，请执行以下操作之一：
以迭代方式运行
deleteMany()方法，直到使用相同过滤的相应查找查询不返回任何文档。在ACID 事务中运行
deleteMany()。安排负载均衡窗口，使数据块迁移仅在特定时间发生，并在指定窗口之外运行任何
deleteMany()操作。
删除单个文档
要删除单个文档，请使用 db.collection.deleteOne()。
或者，使用属于唯一索引一部分的字段，例如 _id。
事务
deleteMany() 可用于分布式事务。
如果是在事务中运行，则请勿显式设置此操作的写关注。要将写关注与事务一起使用，请参阅事务和写关注。
重要
在大多数情况下，与单文档写入操作相比，分布式事务会产生更高的性能成本，并且分布式事务的可用性不应取代有效的模式设计。在许多情况下，非规范化数据模型（嵌入式文档和数组）仍然是数据和使用案例的最佳选择。换言之，对于许多场景，适当的数据建模将最大限度地减少对分布式事务的需求。
有关其他事务使用注意事项（如运行时间限制和 oplog 大小限制），另请参阅生产注意事项。
主节点故障
deleteMany() 一次删除一个文档。如果主节点 (primary node in the replica set) 在 deleteMany() 操作期间失败，则尚未从从节点(secondary node from replica set)删除的文档不会从集合中删除。
Oplog 条目
如果 db.collection.deleteMany() 操作成功删除了一个或多个文档，则该操作会在 oplog（操作日志）上为每个已删除的文档添加一个条目。如果操作失败或者没有找到任何要删除的文档，则操作不会在 oplog 上添加条目。
示例
删除多个文档
orders 集合包含具有以下结构的文档：
db.orders.insertOne( { _id: ObjectId("563237a41a4d68582c2509da"), stock: "Brent Crude Futures", qty: 250, type: "buy-limit", limit: 48.90, creationts: ISODate("2015-11-01T12:30:15Z"), expiryts: ISODate("2015-11-01T12:35:15Z"), client: "Crude Traders Inc." })以下操作会删除所有包含 client : "Crude Traders Inc." 的文档：
try { db.orders.deleteMany( { "client" : "Crude Traders Inc." } );} catch (e) { print (e);}该操作返回：
{ "acknowledged" : true, "deletedCount" : 10 }以下操作会删除stock : "Brent Crude Futures"和limit大于48.88的所有文档：
try { db.orders.deleteMany( { "stock" : "Brent Crude Futures", "limit" : { $gt : 48.88 } } );} catch (e) { print (e);}该操作返回：
{ "acknowledged" : true, "deletedCount" : 8 }具有超时和查询变量的 deleteMany()
以下操作将删除 client 等于 targetClient 变量的所有文档，并将时间限制设置为 3 秒：
try { db.orders.deleteMany( { $expr: { $eq: ["$client", "$$targetClient"] } }, { let: { targetClient: "Crude Traders Inc." }, maxTimeMS: 3000 } );} catch (e) { print(e);}该操作返回：
{ "acknowledged" : true, "deletedCount" : 1 }带有写关注的 deleteMany()
给定一个三成员副本集，以下操作指定 majority 的 w 和 100 的 wtimeout：
try { db.orders.deleteMany( { "client" : "Crude Traders Inc." }, { writeConcern: { w : "majority", wtimeout : 100 }} );} catch (e) { print (e);}如果确认花费的时间超过wtimeout限制，则会引发以下异常：
WriteConcernError({ "code" : 64, "errmsg" : "waiting for replication timed out", "errInfo" : { "wtimeout" : true, "writeConcern" : { "w" : "majority", "wtimeout" : 100, "provenance" : "getLastErrorDefaults" } }})指定排序规则。
排序规则允许用户为字符串比较指定特定于语言的规则，例如字母大小写和重音符号规则。
集合 restaurants 包含以下文档：
db.restaurants.insertMany( [ { _id: 1, category: "café", status: "A" }, { _id: 2, category: "cafe", status: "a" }, { _id: 3, category: "cafE", status: "a" }] )以下操作包括排序规则选项：
db.restaurants.deleteMany( { category: "cafe", status: "A" }, { collation: { locale: "fr", strength: 1 } })为删除操作指定 hint
在 mongosh 中，创建一个 members 集合，其中包含以下文档：
db.members.insertMany([ { "_id" : 1, "member" : "abc123", "status" : "P", "points" : 0, "misc1" : null, "misc2" : null }, { "_id" : 2, "member" : "xyz123", "status" : "A", "points" : 60, "misc1" : "reminder: ping me at 100pts", "misc2" : "Some random comment" }, { "_id" : 3, "member" : "lmn123", "status" : "P", "points" : 0, "misc1" : null, "misc2" : null }, { "_id" : 4, "member" : "pqr123", "status" : "D", "points" : 20, "misc1" : "Deactivated", "misc2" : null }, { "_id" : 5, "member" : "ijk123", "status" : "P", "points" : 0, "misc1" : null, "misc2" : null }, { "_id" : 6, "member" : "cde123", "status" : "A", "points" : 86, "misc1" : "reminder: ping me at 100pts", "misc2" : "Some random comment" }])在集合上创建以下索引：
db.members.createIndex( { status: 1 } )db.members.createIndex( { points: 1 } )以下删除操作明确提示使用索引 { status: 1 }：
db.members.deleteMany( { "points": { $lte: 20 }, "status": "P" }, { hint: { status: 1 } })注意
如果指定不存在的索引，则操作出错。
删除命令返回以下内容：
{ "acknowledged" : true, "deletedCount" : 3 }要查看使用的索引，可以使用 $indexStats 管道：
db.members.aggregate( [ { $indexStats: { } }, { $sort: { name: 1 } } ] )$indexStats 输出中的 accesses.ops 字段表示使用该索引的操作次数。