Navigation
This version of the documentation is archived and no longer supported.

dropDatabase

On this page

Definition

dropDatabase

The dropDatabase command drops the current database, deleting the associated data files.

The command has the following form:

{ dropDatabase: 1, writeConcern: <document>}

The command takes the following optional field:

Field Description
writeConcern

Optional. A document expressing the write concern to use if greater than "majority"

{ w: <value>, j: <boolean>, wtimeout: <number> }

Omit to use the default/minimum write concern of "majority".

When issued on a replica set, if the specified write concern results in fewer member acknowledgements than write concern "majority", the operation uses "majority". Otherwise, the specified write concern is used.

When issued on a sharded cluster, MongoDB converts the write concern of the dropDatabase command to "majority".

The mongo shell also provides the helper method db.dropDatabase().

Behavior

Locks

Starting in versions 3.6, the operation takes an exclusive (X) database lock while dropping the collections in the database but a global lock when dropping the now-empty database.

User Management

Changed in version 2.6: This command does not delete the users associated with the current database. To drop the associated users, run the dropAllUsersFromDatabase command in the database you are deleting.

Replica Set and Sharded Clusters

Changed in version 4.0.

Replica Sets

At minimum, the method waits until all collection drops in the database have propagated to a majority of the replica set members (i.e. uses the write concern "majority").

If you specify a write concern that requires acknowledgement from fewer than the majority, the command uses write concern "majority".

If you specify a write concern that requires acknowledgement from more than the majority, the command uses the specified write concern.

Sharded Clusters

When issued on a sharded cluster, MongoDB converts the write concern of the dropDatabase command to "majority".

If you intend to create a new database with the same name as the dropped database, you must follow these additional steps for using the dropDatabase command with MongoDB 4.0 or previous:

  1. Run the dropDatabase command on a mongos.

  2. Connect to each shard’s primary and verify that the namespace has been dropped. If it has not, rerun the dropDatabase command again directly from the primary.

  3. Connect to a mongos, switch to the config database, and remove any reference to the removed namespace from the databases, collections, chunks, tags, and locks collections:

    use config
    db.collections.remove( { _id: /^DATABASE\./ }, {writeConcern: {w: 'majority' }} )
    db.databases.remove( { _id: "DATABASE" }, {writeConcern: {w: 'majority' }} )
    db.chunks.remove( { ns: /^DATABASE\./ }, {writeConcern: {w: 'majority' }} )
    db.tags.remove( { ns: /^DATABASE\./ }, {writeConcern: {w: 'majority' }} )
    db.locks.remove( { _id: /^DATABASE\./ }, {writeConcern: {w: 'majority' }} )
    

    Where DATABASE represents the namespace of the database you just dropped.

  4. Connect to the primary of each shard, and remove any reference to the removed namespace from the cache.databases, cache.collections, and cache.chunks.DATABASE.COLLECTION collections:

    db.getSiblingDB("config").cache.databases.remove({_id:"DATABASE"}, {writeConcern: {w: 'majority' }});
    db.getSiblingDB("config").cache.collections.remove({_id:/^DATABASE.*/}, {writeConcern: {w: 'majority' }});
    db.getSiblingDB("config").getCollectionNames().forEach(function(y) {
       if(y.indexOf("cache.chunks.DATABASE.") == 0)
        db.getSiblingDB("config").getCollection(y).drop()
     })
    

    Where DATABASE represents the namespace of the database you just dropped.

  5. Use the flushRouterConfig command on all mongos instances before reading or writing to that database.

These steps ensure that all cluster nodes refresh their metadata cache, which includes the location of the primary shard for the new database. Otherwise, you may miss data on reads, and may not write data to the correct shard. To recover, you must manually intervene.

Change Streams

The db.dropDatabase() method and dropDatabase create an invalidate Event for any Change Streams opened on the dropped database or opened on the collections in the dropped database.

Example

The following example in the mongo shell uses the use <database> operation to switch the current database to the temp database and then uses the dropDatabase command to drop the temp database:

use temp
db.runCommand( { dropDatabase: 1 } )
←   drop dropIndexes  →