- Reference >
mongo
Shell Methods >- Collection Methods >
- db.collection.drop()
db.collection.drop()¶
On this page
Definition¶
-
db.collection.
drop
(<options>)¶ Important
mongo
Shell MethodThis page documents a
mongo
method. This is not the documentation for database commands or language-specific drivers, such as Node.js. To use the database command, see thedrop
command.For MongoDB API drivers, refer to the language-specific MongoDB driver documentation.
Removes a collection or view from the database. The method also removes any indexes associated with the dropped collection. The method provides a wrapper around the
drop
command.Note
For a sharded cluster, if you use
db.collection.drop()
and then create a new collection with the same name, you must either:- Flush the cached routing table on every
mongos
usingflushRouterConfig
. - Use
db.collection.remove()
to remove the existing documents and reuse the collection. Use this approach to avoid flushing the cache.
db.collection.drop()
has the form:db.collection.drop()
takes an optional document with the following field:Field Description writeConcern Optional. A document expressing the write concern of the
db.collection.drop()
operation. Omit to use the default write concern.When issued on a sharded cluster,
mongos
converts the write concern of thedrop
command and its helperdb.collection.drop()
to"majority"
.Returns: true
when successfully drops a collection.false
when collection to drop does not exist.
- Flush the cached routing table on every
Behavior¶
- The
db.collection.drop()
method anddrop
command create an invalidate for any Change Streams opened on dropped collection. - Dropping a collection deletes its associated zone/tag ranges.
Resource Locking¶
Changed in version 4.2.
db.collection.drop()
obtains an exclusive lock on the specified collection
for the duration of the operation. All subsequent operations on the
collection must wait until db.collection.drop()
releases the
lock.
Prior to MongoDB 4.2, db.collection.drop()
obtained an exclusive
lock on the parent database, blocking all operations on the
database and all its collections until the operation completed.
Example¶
Drop a Collection Using Default Write Concern¶
The following operation drops the students
collection in the
current database.
Drop a Collection Using w: "majority"
Write Concern¶
db.collection.drop()
accepts an options document.
The following operation drops the students
collection in the
current database. The operation uses the "majority"
write concern: