db.collection.remove()
在本页面
定义
db.collection.
remove
()
从集合中删除文档。
db.collection.remove()方法可以具有两种语法之一。 remove()方法可以采用查询文档和可选的justOne
boolean:
或者该方法可以采用查询文档和可选的删除选项文档:
version 2.6 中的新内容。
remove()返回包含操作状态的 object。
行为
写关注
remove()方法使用删除命令,该命令使用默认的写关注。要指定其他写入问题,请在 options 参数中包含写入关注点。
查询注意事项
默认情况下,remove()删除 match query
表达式的所有文档。指定justOne
选项以限制删除单个文档的操作。要删除按指定 order 排序的单个文档,请使用findAndModify()方法。
删除多个文档时,删除操作可能与对集合的其他读 and/or 写操作交错。
上限集合
您不能将remove()方法与上限集合一起使用。
分片集合
指定justOne
选项的分片集合的所有remove()操作必须包含查询规范中的碎片 key或_id
字段。 remove()操作在分片集合中指定justOne
,不包含碎片 key或_id
字段返回错误。
事务
db.collection.remove()
可以在多文档事务中使用。
如果在事务中运行,请不要为操作明确设置写关注点。要对事务使用写关注,请参见 事务和写关注。
重要
在大多数情况下,与单文档写入相比,多文档事务产生的性能成本更高,并且多文档事务的可用性不应替代有效的架构设计。在许多情况下, 非规范化数据模型(嵌入式文档和数组)将继续是您的数据和用例的最佳选择。也就是说,在许多情况下,适当地对数据建模将最大程度地减少对多文档交易的需求。
有关其他事务使用方面的注意事项(例如运行时限制和操作日志大小限制),另请参见 生产注意事项。
例子
以下是remove()方法的示例。
从集合中删除所有文档
要删除集合中的所有文档,请使用空查询文档{}
调用去掉方法。以下操作将删除bios 系列中的所有文档:
此操作不等同于drop()方法。
要从集合中删除所有文档,使用drop()方法删除整个集合(包括索引),然后重新创建集合并重建索引可能更有效。
删除符合的所有文档
要删除匹配删除条件的文档,请使用<query>
参数调用remove()方法:
以下操作将从集合products
中删除qty
大于20
的所有文档:
覆盖默认写入关注
对副本集的以下操作将删除集合products
中qty
大于20
的所有文档,并指定"w: majority"
的"w: majority"
,其wtimeout
为 5000 毫秒,以便该方法在写入传播到大多数表决副本集后返回成员或方法在 5 秒后超时。
删除匹配条件的单个文档
要删除匹配删除条件的第一个文档,请使用query
条件调用去掉方法,并将justOne
参数设置为true
或1
。
以下操作从集合products
中删除第一个文档,其中qty
大于20
:
指定排序规则
version 3.4 中的新内容。
整理允许用户为 string 比较指定 language-specific 规则,例如字母和重音标记的规则。
集合myColl
具有以下文档:
以下操作包括整理选项:
写结果
更改了 version 2.6.
成功的结果
remove()返回包含操作状态的写结果 object。成功后,写结果 object 包含有关删除的文档数量的信息:
也可以看看
WriteResult.nRemoved
写下关注错误
如果remove()方法遇到写入关注错误,则结果包括WriteResult.writeConcernError字段:
也可以看看
WriteResult.hasWriteConcernError()
与写关注无关的错误
如果remove()方法遇到 non-write 关注错误,则结果包括WriteResult.writeError字段:
也可以看看
WriteResult.hasWriteError()
译者:李冠飞
校对:
最后更新于