- Reference >
mongo
Shell Methods >- Collection Methods >
- db.collection.deleteMany()
db.collection.deleteMany()¶
On this page
Definition¶
-
db.collection.
deleteMany
()¶ Removes all documents that match the
filter
from a collection.Parameter Type Description filter
document Specifies deletion criteria using query operators.
To delete all documents in a collection, pass in an empty document (
{ }
).writeConcern
document Optional. A document expressing the write concern. Omit to use the default write concern. Returns: A document containing: - A boolean
acknowledged
astrue
if the operation ran with write concern orfalse
if write concern was disabled
deletedCount
containing the number of deleted documents
- A boolean
Behavior¶
Capped Collections¶
deleteMany()
throws a WriteError
exception
if used on a capped collection. To remove all documents from a capped
collection, use db.collection.drop()
instead.
Delete a Single Document¶
To delete a single document, use db.collection.deleteOne()
instead.
Alternatively, use a field that is a part of a unique index such as
_id
.
Examples¶
Delete Multiple Documents¶
The orders
collection has documents with the following structure:
The following operation deletes all documents where client : "Crude Traders
Inc."
:
The operation returns:
The following operation deletes all documents where stock : "Brent Crude
Futures"
and limit
is greater than 48.88
:
The operation returns:
deleteMany() with Write Concern¶
Given a three member replica set, the following operation specifies a
w
of majority
and wtimeout
of 100
:
If the acknowledgement takes longer than the wtimeout
limit, the following
exception is thrown: