drop (comando de base de datos)

Esta versión de la documentación está archivada y ya no recibe soporte. Para actualizar su implementación 6.0, consulte Procedimientos de actualización de MongoDB.7.0

Definición

drop: El comando elimina una colección completa de una base de drop datos.
Tip
mongoshEn, este comando también se puede ejecutar a través del drop() método auxiliar.
Los métodos asistente son convenientes para usuarios de mongosh, pero es posible que no proporcionen el mismo nivel de información que los comandos de base de datos. En los casos en que no se necesite la conveniencia o se requieran campos de retorno adicionales, utiliza el comando de base de datos.

Compatibilidad

Este comando está disponible en implementaciones alojadas en los siguientes entornos:

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

Nota

Este comando es compatible con todos los clústeres de MongoDB Atlas. Para obtener información sobre el soporte de Atlas para todos los comandos, consulte Comandos no compatibles.

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.

Sintaxis

El comando tiene la siguiente sintaxis:

db.runCommand(
   {
     drop: <collection_name>,
     writeConcern: <document>,
     comment: <any>
   }
)

Campos de comandos

El comando toma los siguientes campos:

Campo	Descripción
`drop`	El nombre de la colección que se va a soltar.
`writeConcern`	Opcional. Un documento que expresa el nivel de confirmación de escritura del comando `drop`. Se puede omitir usar el nivel de confirmación de escritura por defecto. Cuando se emite en un clúster particionado, `mongos` convierte el nivel de confirmación de escritura del comando `drop` y su asistente `db.collection.drop()` a `"majority"`.
`comment`	Opcional. Un comentario proporcionado por el usuario para adjuntar a este comando. Una vez configurado, este comentario aparece junto a los registros de este comando en las siguientes ubicaciones: Mensajes de registro de mongod, en el campo `attr.command.cursor.comment`. Salida del perfilador de base de datos, en el campo `command.comment`. `currentOp` de salida, en el campo `command.comment`. Un comentario puede ser de cualquier tipo BSON válido (string, objeto, arreglo, etc.).

mongosh proporciona el método auxiliar db.collection.drop() equivalente.

Comportamiento

A partir de MongoDB,5.0 el comando drop db.collection.drop() y el método generarán un error si se pasa un parámetro no reconocido.
Este comando también elimina cualquier índice asociado con la colección eliminada.
El db.collection.drop() método y drop el comando cancelan cualquier creación de índice en curso en la colección de destino antes de descartar la colección.
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.
El comando drop y su ayudante crean db.collection.drop() un evento de invalidación para cualquier flujo de cambio abierto en la colección descartada.
Al descartar una colección, se borran sus rangos de zona/etiqueta asociados.
A partir de MongoDB,5.0 el comando drop y el método devuelven un error si db.collection.drop() se intenta eliminar una colección en la base de datos de administración o de configuración desde un. Para eliminar mongos estas colecciones, conéctese al servidor de configuración y ejecute el comando allí.
Advertencia
Eliminar colecciones en la base de datos admin o en la base de datos de configuración puede dejar su clúster en un estado inutilizable.

Bloqueo de recursos

drop obtiene un bloqueo exclusivo en la colección especificada por el tiempo que dure la operación. Todas las operaciones posteriores en la colección deben esperar hasta que drop libere el bloqueo.

Volver

currentOp

dropDatabase