dropRole (comando de base de datos)

Definición

dropRole: Elimina un rol definido por el usuario de la base de datos en la que ejecuta el comando.
Tip
In mongosh, this command can also be run through the db.dropRole() helper method.
Helper methods are convenient for mongosh users, but they may not return the same level of information as database commands. In cases where the convenience is not needed or the additional return fields are required, use the database command.

Compatibilidad

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

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.

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.

Sintaxis

El comando tiene la siguiente sintaxis:

db.runCommand(
   {
     dropRole: "<role>",
     writeConcern: { <write concern> },
     comment: <any>
   }
)

Campos de comandos

El comando tiene los siguientes campos:

Campo	Tipo	Descripción
`dropRole`	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).
`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.).

Comportamiento

Autenticación

Cuando se descarta un rol en un mongod, los usuarios autenticados permanecen con sesión iniciada a la base de datos pero pierden inmediatamente los privilegios del 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.

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.runCommand(
   {
     dropRole: "readPrices",
     writeConcern: { w: "majority" }
   }
)

Volver

createRole

dropAllRolesFromDatabase