db.collection.remove（）_MonogDB 中文网

MongoDB 中文手册

参考 > 参考 > mongo Shell方法 > 收集方法 > db.collection.remove（）

在本页面

定义
行为
例子
写结果

定义¶

db.collection.remove（）¶

mongo 壳法

此页面记录了mongoshell方法，并且没有引用MongoDB Node.js驱动程序（或任何其他驱动程序）方法。对于相应的MongoDB驱动程序API，请改为参考您特定的 MongoDB驱动程序文档。

从集合中删除文档。

该db.collection.remove()方法可以具有两种语法之一。该remove()方法可以获取查询文档和可选的justOne布尔值：

复制

db.collection.remove(
   <query>,
   <justOne>
)

或者该方法可以获取查询文档和可选的删除选项文档：

复制

db.collection.remove(
   <query>,
   {
     justOne: <boolean>,
     writeConcern: <document>,
     collation: <document>
   }
)

参数	类型	描述
`query`	文献	使用查询运算符指定删除条件。要删除集合中的所有文档，请传递一个空文档（`{}`）。
`justOne`	布尔值	可选的。要将删除限制为仅一个文档，请设置为`true`。忽略使用默认值，`false`并删除所有符合删除条件的文档。
`writeConcern`	文献	可选的。表达书面关切的文件。省略使用默认的写关注。请参阅写关注点。如果在事务中运行，则不要为操作明确设置写关注点。要对事务使用写关注，请参见事务和写关注。
`collation`	文献	可选的。指定用于操作的排序规则。归类允许用户为字符串比较指定特定于语言的规则，例如字母大写和重音符号的规则。排序规则选项具有以下语法：复制 collation: { locale: <string>, caseLevel: <boolean>, caseFirst: <string>, strength: <int>, numericOrdering: <boolean>, alternate: <string>, maxVariable: <string>, backwards: <boolean> } 指定排序规则时，该`locale`字段为必填字段；所有其他排序规则字段都是可选的。有关字段的说明，请参见整理文档。如果未指定排序规则，但是集合具有默认排序规则（请参阅参考资料`db.createCollection()`），则该操作将使用为集合指定的排序规则。如果没有为集合或操作指定排序规则，则MongoDB使用先前版本中使用的简单二进制比较进行字符串比较。您不能为一个操作指定多个排序规则。例如，您不能为每个字段指定不同的排序规则，或者如果对排序执行查找，则不能对查找使用一种排序规则，而对排序使用另一种排序规则。 3.4版的新功能。

该remove()返回包含操作的状态的对象。

返回值：	一写结果包含操作的状态对象。

行为¶

写关注¶

该remove()方法使用 delete命令，该命令使用默认的写入关注。要指定其他写关注点，请在options参数中包括写关注点。

查询注意事项¶

默认情况下，remove()删除所有与query表达式匹配的文档。指定justOne用于将操作限制为删除单个文档的选项。要删除按指定顺序排序的单个文档，请使用findAndModify（）方法。

当删除多个文档时，删除操作可能会与其他对集合的读取和/或写入操作交错。

封顶集合¶

您不能将remove()方法与上限集合一起使用。

分片集合¶

remove()指定justOne选项的分片集合的所有操作都必须包括分片键或_id查询规范中的字段。在不包含分片键或字段的分片集合中 remove()指定的操作将返回错误。justOne_id

交易¶

db.collection.remove()可以在多文档交易中使用。

如果在事务中运行，则不要为操作明确设置写关注点。要对事务使用写关注，请参见事务和写关注。

重要

在大多数情况下，与单文档写入相比，多文档事务产生的性能成本更高，并且多文档事务的可用性不应代替有效的架构设计。在许多情况下，非规范化数据模型（嵌入式文档和数组）对于您的数据和用例将继续是最佳的。也就是说，在许多情况下，对数据进行适当的建模将最大程度地减少对多文档交易的需求。

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

例子¶

以下是该remove()方法的示例。

从集合中删除所有文档¶

要删除集合中的所有文档，请remove使用空的查询文档调用该方法{}。以下操作将从bios集合中删除所有文档：

复制

db.bios.remove( { } )

此操作不等同于该 drop()方法。

要从集合中删除所有文档，使用该drop()方法删除整个集合（包括索引），然后重新创建集合并重建索引，可能会更有效。

删除所有符合条件的文档¶

要删除符合删除条件的文档，请remove()使用<query> 参数调用方法：

以下操作从集合products中删除qty大于的所有文档 20：

复制

db.products.remove( { qty: { $gt: 20 } } )

覆盖默认写问题¶

以下操作副本集删除所有从收集的文件products，其中qty大于20并指定写入关注的有5000毫秒，使得写传播后，该方法返回一个多数投票副本集成员或方法的5秒后超时。"w: majority"wtimeout

复制

db.products.remove(
    { qty: { $gt: 20 } },
    { writeConcern: { w: "majority", wtimeout: 5000 } }
)

删除符合条件的单个文档¶

要删除符合删除条件的第一个文档，请 remove使用query 条件将其justOne参数设置为true或的方法1。

以下操作从集合products中删除第一个qty大于的文档 20：

复制

db.products.remove( { qty: { $gt: 20 } }, true )

指定归类¶

3.4版的新功能。

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

集合myColl包含以下文档：

复制

{ _id: 1, category: "café", status: "A" }
{ _id: 2, category: "cafe", status: "a" }
{ _id: 3, category: "cafE", status: "a" }

以下操作包括排序规则选项：

复制

db.myColl.remove(
   { category: "cafe", status: "A" },
   { collation: { locale: "fr", strength: 1 } }
)

写结果¶

成功的结果¶

将remove()返回WriteResult 一个包含操作的状态对象。成功后，该 WriteResult对象包含有关已删除文档数的信息：

复制

WriteResult({ "nRemoved" : 4 })

也可以看看

WriteResult.nRemoved

写关注错误¶

如果该remove()方法遇到写关注错误，则结果包括以下 WriteResult.writeConcernError字段：

复制

WriteResult({
   "nRemoved" : 21,
   "writeConcernError" : {
      "code" : 64,
      "errInfo" : {
         "wtimeout" : true
      },
      "errmsg" : "waiting for replication timed out"
   }
})

也可以看看

WriteResult.hasWriteConcernError()

与写关注无关的错误¶

如果该remove()方法遇到非写关注错误，则结果包括WriteResult.writeError字段：

复制

WriteResult({
   "nRemoved" : 0,
   "writeError" : {
      "code" : 2,
      "errmsg" : "unknown top level operator: $invalidFieldName"
   }
})

也可以看看

WriteResult.hasWriteError()