db.dropRole() (método mongosh)

Definición

db.dropRole( rolename, writeConcern )

Elimina un rol definido por el usuario de la base de datos en la que ejecuta el método.

Importante

Método mongosh

Esta página documenta a Método mongosh. Esta no es la documentación de comandos de base de datos ni de controladores específicos del lenguaje, como Node.js.

Para el comando de base de datos, consulta el comando dropRole.

Para los drivers de API de MongoDB, consulte la documentación del driver de MongoDB específica del lenguaje.

El método db.dropRole() toma los siguientes argumentos:

Parameter	Tipo	Descripción
`rolename`	string	El nombre del rol definido por el usuario que se va a remover de la base de datos.
`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).

Compatibilidad

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

Importante

Este comando no es compatible con los clústeres de MongoDB Atlas. Para obtener información sobre el soporte de Atlas para todos los comandos, consulta 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.

Comportamiento

Autenticación

Cuando se elimina un rol en un, los usuarios autenticados previamente permanecen conectados a la base de datos, pero pierden inmediatamente los privilegios del mongod rol.

Cuando se descarta un rol en un mongos, los usuarios previamente autenticados permanecen con sesión iniciada a la base de datos, pero pierden los privilegios del rol cuando se actualiza la caché. La caché se actualiza automáticamente después del tiempo especificado con el parámetro userCacheInvalidationIntervalSecs o manualmente cuando se ejecuta el comando invalidateUserCache.

Set de réplicas

Si se ejecuta en un set de réplicas, db.dropRole() se ejecuta utilizando el nivel de confirmación de escritura "majority" por defecto.

Acceso requerido

Debes tener la dropRole acción en una base de datos para descartar un rol de esa base de datos.

Ejemplo

Las siguientes operaciones remueven el rol readPrices de la base de datos products:

use products
db.dropRole( "readPrices", { w: "majority" } )

Volver

db.createRole

db.dropAllRoles