Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.
Docs Menu

db.dropDatabase() (método mongosh)

db.dropDatabase(<writeConcern>)

Remueve la base de datos actual, borrando los archivos de datos asociados.

Este método está disponible en implementaciones alojadas en los siguientes entornos:

  • MongoDB Atlas: El servicio totalmente gestionado para implementaciones de MongoDB en la nube

Nota

This command is supported in all MongoDB Atlas clusters. For information on Atlas support for all commands, see Unsupported Commands.

  • MongoDB Enterprise: La versión basada en suscripción y autogestionada de MongoDB

  • MongoDB Community: La versión de MongoDB con código fuente disponible, de uso gratuito y autogestionada.

db.dropDatabase() toma un parámetro opcional:

Campo
Descripción

writeConcern

opcional. Un documento que exprese el nivel de confirmación de escritura (write concern) a utilizar si es mayor que "majority".

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

Omita para usar el nivel de confirmación de escritura (write concern) predeterminado/mínimo de "majority".

Cuando se emite en un set de réplicas, si el nivel de confirmación de escritura (write concern) especificado da como resultado un menor reconocimiento entre los nodos que el nivel de confirmación de escritura (write concern) "majority", la operación utiliza "majority". De lo contrario, se utiliza el nivel de confirmación de escritura (write concern) especificado.

Cuando se emite en un clúster particionado, MongoDB convierte el nivel de confirmación de escritura especificado en "majority".

See also Behavior.

dropDatabase() encapsula el comando dropDatabase.

La operación toma un bloqueo exclusivo (X) de la base de datos solamente.

Este comando no elimina a los usuarios asociados a la base de datos actual. Para descartar los usuarios asociados, ejecute el comando dropAllUsersFromDatabase en la base de datos que está borrando.

The db.dropDatabase() method and dropDatabase command abort any in-progress index builds on collections in the target database before dropping the database. Aborting an index build has the same effect as dropping the built index.

Para sets de réplicas o sets de réplicas de fragmentos, abortar un índice en el primario no anula simultáneamente las construcciones de índices secundarios. MongoDB intenta abortar las compilaciones en curso para los índices especificados en el primario y, si es exitoso, crea una entrada de oplog abort asociada. Los miembros secundarios con compilaciones replicadas en progreso esperan una entrada de confirmación o anulación de oplog del primario antes de confirmar o anular la creación de índices.

Sets de réplicas

Como mínimo, dropDatabase() espera hasta que todos los descartes de colección en la base de datos se hayan propagado a la mayoría de los nodos del set de réplicas, utilizando el nivel de confirmación de escritura (write concern) "majority".

Se puede especificar un nivel de confirmación de escritura en el método. Si se especifica un nivel de confirmación de escritura que requiere el reconocimiento de menos de la mayoría, el método utiliza el nivel de confirmación de escritura "majority".

Si especificas un nivel de confirmación de escritura (write concern) que requiere el reconocimiento de más que la mayoría, el método utiliza el nivel de confirmación de escritura (write concern) especificado.

Clústeres fragmentados

Cuando se emite en un clúster particionado, MongoDB convierte el nivel de confirmación de escritura especificado en "majority".

Si tienes la intención de crear una nueva base de datos con el mismo nombre que la base de datos descartada, debes ejecutar el comando dropDatabase en un mongos.

Esto garantiza que todos los nodos del clúster actualicen su caché de metadatos, que incluye la ubicación de la partición primaria para la nueva base de datos. De lo contrario, podrías perder datos en las lecturas y no guardar los datos en la partición correcta. Para recuperar, debe intervenir manualmente.

A partir de MongoDB,5.0 el comando dropDatabase y el método devuelven un db.dropDatabase() error si intenta eliminar la base de datos admin o la base de datos config de mongos un.

Advertencia

Eliminar la base de datos admin o la base de datos de configuración puede dejar el clúster en un estado inutilizable.

El método db.dropDatabase() y el comando dropDatabase crean un evento de invalidación para cualquier MongoDB Change Streams abierto en la base de datos descartada o sus colecciones.

The following example in mongosh uses the use <database> operation to switch the current database to the temp database and then uses dropDatabase() to drop the temp database:

use temp
db.dropDatabase()