dropUser (comando de base de datos)

Esta versión de la documentación se archivó y ya no se admite. Para actualizar tu implementación de 6.0, consulta el Procedimientos de actualización de MongoDB.7.0

Definición

dropUser: Remueve al usuario de la base de datos en la que ejecutas el comando.
Tip
En mongosh, este comando también se puede ejecutar a través del db.dropUser() método asistente.
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

Importante

Este comando no está soportado en los clústeres M10+. Para más información, consulta Comandos no soportados.

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(
   {
     dropUser: "<user>",
     writeConcern: { <write concern> },
     comment: <any>
   }
)

Campos de comandos

El comando tiene los siguientes campos:

Campo	Tipo	Descripción
`dropUser`	string	El nombre del usuario que se eliminará. Debe ejecutar el `dropUser` comando mientras usa la base de datos donde existe el usuario.
`writeConcern`	Documento	Opcional. El nivel de confirmación de escritura (write concern) de la operación. Consulte Especificación de nivel de confirmación de escritura (write concern).
`comment`	any	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.).

Antes de eliminar a un usuario que tenga el rol userAdminAnyDatabase, asegúrate de tener al menos otro usuario con privilegios de administración de usuarios.

Acceso requerido

Debes tener la dropUser acción sobre una base de datos para descartar a un usuario de esa base de datos.

Ejemplo

La siguiente secuencia de operaciones en mongosh remueve reportUser1 de la base de datos products:

use products
db.runCommand( {
   dropUser: "reportUser1",
   writeConcern: { w: "majority", wtimeout: 5000 }
} )

Volver

eliminarTodosLosUsuariosDeLaBaseDeDatos

grantRolesToUser