Make the MongoDB docs better! We value your opinion. Share your feedback for a chance to win $100.
Click here >
Docs 菜单
Docs 主页
/
开发中
/
mongosh 方法
Docs 主页
/
开发中
/
mongosh 方法
Docs 主页
/
开发中
/
mongosh 方法

db. 集合.deleteMany()（mongosh方法）

带驱动程序的 MongoDB

本页面提供 mongosh 方法的相关信息。要查看 MongoDB 驱动程序中的等效方法，请参阅编程语言的相应页面：

C#Java SyncNode.jsPyMongoCC++GoJava RSKotlin CoroutineKotlin SyncPHPMongoidRustScala

定义

db.collection.deleteMany()

从集合中删除与 filter 匹配的所有文档。

返回：文档包含以下内容：

  • 如果操作使用 写关注来运行，则布尔值 acknowledged 为 true；如果已禁用写关注，则为 false

  • deletedCount 包含已删除文档的数量

注意

如果要删除大型集合中的所有文档，则删除该集合并重新创建可能速度更快。在删除集合之前，请记下集合上的所有索引。您必须重新创建原始集合中存在的任何索引。如果原始集合是分片的，则对重新创建的集合也要分片。

有关删除集合的更多信息，请参阅 db.collection.drop()。

兼容性

此方法可用于以下环境中托管的部署：

注意

所有 MongoDB Atlas 集群都支持此命令。有关 Atlas 对所有命令的支持的信息，请参阅不支持的命令。

语法

deleteMany() 方法使用的语法如下：

db.collection.deleteMany(
   <filter>,
   {
      writeConcern: <document>,
      collation: <document>,
      hint: <document>|<string>,
      maxTimeMS: <int>,
      let: <document>
   }
)
Parameter
类型
说明

筛选器

文档

使用查询运算符指定删除条件。

要删除集合中的所有文档，请传入空文档 ({ })。

writeConcern

文档

可选。表达写关注的文档。省略以使用默认写关注。

如果是在事务中运行，则请勿显式设置此操作的写关注。要将写关注与事务一起使用，请参阅事务和写关注。

排序规则

文档

可选。

指定用于操作的排序规则。

排序规则允许用户为字符串比较指定特定于语言的规则，例如字母大小写和重音符号规则。

排序规则选项的语法如下：

collation: {
    locale: <string>,
    caseLevel: <boolean>,
    caseFirst: <string>,
    strength: <int>,
    numericOrdering: <boolean>,
    alternate: <string>,
    maxVariable: <string>,
    backwards: <boolean>
 }

指定排序规则时，locale 字段为必填字段；所有其他排序规则字段均为可选字段。有关字段的说明，请参阅排序规则文档。

如果未指定排序规则，但集合具有默认排序规则（请参阅 db.createCollection()），则操作将使用为集合指定的排序规则。

如果没有为收集或操作指定排序规则，MongoDB 将使用先前版本中使用的简单二进制比较来进行字符串比较。

您不能为一个操作指定多个排序规则。例如，您不能为每个字段指定不同的排序规则，或者如果执行带排序的查找，则不能使用一种排序规则进行查找而另一种排序规则进行排序。

提示

文档

可选。 指定用于支持查询谓词的索引的文档或字符串。

该选项可以采用索引规范文档或索引名称字符串。

如果指定不存在的索引，则操作出错。

有关示例，请参阅为删除操作指定 hint。

maxTimeMS

整型

可选。指定删除操作在超时之前运行的时间限制（以毫秒为单位）。

let

文档

可选。

指定包含变量列表的文档。这样可以将变量与查询文本分开，从而提高命令的可读性。

文档语法为：

{
  <variable_name_1>: <expression_1>,
  ...,
  <variable_name_n>: <expression_n>
}

变量设置为表达式返回的值，并且之后不能再进行更改。

要访问命令中的变量值，请使用双美元符号前缀 ($$) 以及 $$<variable_name> 形式的变量名称。例如：$$targetTotal。

要使用变量筛选结果，您必须在 $expr 操作符中访问该变量。

有关使用 let 和变量的完整示例，请参阅使用 let 变量进行更新。

行为

分片集合

  • 如果deleteMany()在事务之外运行，针对多个分片的操作会将该操作广播到集群中的所有分片。

  • 如果 deleteMany() 在ACID 事务中运行，则针对多个分片的操作仅针对相关分片。

警告

由于存在并发数据块迁移，deleteMany()运行可能不会删除与指定过滤匹配的所有文档。为确保删除所有匹配的文档，请执行以下操作之一：

  • 以迭代方式运行 deleteMany() 方法，直到使用相同过滤的相应查找查询不返回任何文档。

  • 在ACID 事务中运行 deleteMany()。

  • 安排负载均衡窗口，使数据块迁移仅在特定时间发生，并在指定窗口之外运行任何 deleteMany() 操作。

删除单个文档

要删除单个文档，请使用 db.collection.deleteOne()。

或者，使用属于唯一索引一部分的字段，例如 _id。

事务

db.collection.deleteMany() 可以在分布式事务中使用。

如果是在事务中运行，则请勿显式设置此操作的写关注。要将写关注与事务一起使用，请参阅事务和写关注。

重要

在大多数情况下，与单文档写入操作相比，分布式事务会产生更高的性能成本，并且分布式事务的可用性不应取代有效的模式设计。在许多情况下，非规范化数据模型（嵌入式文档和数组）仍然是数据和使用案例的最佳选择。换言之，对于许多场景，适当的数据建模将最大限度地减少对分布式事务的需求。

有关其他事务使用注意事项（如运行时间限制和 oplog 大小限制），另请参阅生产注意事项。

主节点故障

db.collection.deleteMany() 一次删除一个文档。如果主节点在 db.collection.deleteMany() 操作期间出现故障，则尚未从从节点中删除的文档不会从集合中删除。

Oplog 条目

如果 db.collection.deleteMany() 操作成功删除了一个或多个文档，则该操作会在 oplog（操作日志）上为每个已删除的文档添加一个条目。如果操作失败或者没有找到任何要删除的文档，则操作不会在 oplog 上添加条目。

示例

本页上的示例使用 sample_mflix示例数据集 中的数据。有关如何将此数据集加载到自管理MongoDB 部署中的详细信息，请参阅加载示例数据集。如果对示例数据库进行了任何修改，则可能需要删除并重新创建数据库才能运行本页上的示例。

删除多个文档

以下操作会删除 year 早于 1910 的所有文档：

db.movies.deleteMany( { "year": { $lt: 1910 } } )
{ acknowledged: true, deletedCount: 4 }

同样，此操作会删除 rated 等于 "G" 且 year 早于 1950 的所有文档：

db.movies.deleteMany( { "rated": "G", "year": { $lt: 1950 } } )
{ acknowledged: true, deletedCount: 9 }

具有超时和查询变量的 deleteMany()

以下操作删除 year 早于 cutoffYear 变量的所有文档。该示例还设置了 3 秒的时间限制：

db.movies.deleteMany(
    { $expr: { $lt: [ "$year", "$$cutoffYear" ] } },
    {
        let: { cutoffYear: 1910 },
        maxTimeMS: 3000
    }
)
{ acknowledged: true, deletedCount: 4 }

带有写关注的 deleteMany()

给定一个三成员副本集，以下操作指定 majority 的 w 和 100 的 wtimeout：

db.movies.deleteMany(
    { "rated": "G", "year": { $lt: 1950 } },
    { writeConcern: { w: "majority", wtimeout: 100 } }
)
{ acknowledged: true, deletedCount: 9 }

如果确认时间超过 wtimeout 限制， MongoDB将引发写关注（write concern）错误。

指定排序规则。

排序规则允许用户为字符串比较指定特定于语言的规则，例如字母大小写和重音符号规则。

以下操作使用具有英语区域设置和strength: 2 的排序规则选项。过滤rated: "g" rated: "G"会匹配集合中存储的具有 的文档：

db.movies.deleteMany(
   { rated: "g", year: { $lt: 1950 } },
   { collation: { locale: "en", strength: 2 } }
)
{ acknowledged: true, deletedCount: 9 }

为删除操作指定 hint

在 rated 和 metacritic 字段上创建索引：

db.movies.createIndex( { rated: 1 } )
db.movies.createIndex( { metacritic: 1 } )

以下删除操作明确提示使用索引 { rated: 1 }：

db.movies.deleteMany(
   { "metacritic": { $lte: 15 }, "rated": "PG" },
   { hint: { rated: 1 } }
)
{ acknowledged: true, deletedCount: 7 }

注意

如果指定不存在的索引，则操作出错。

要查看使用的索引，可以使用 $indexStats 管道：

db.movies.aggregate( [ { $indexStats: { } }, { $sort: { name: 1 } } ] )

$indexStats 输出中的 accesses.ops 字段表示使用该索引的操作次数。

后退

db.collection.dataSize

来年

db.collection.deleteOne

在此页面上