db.dropRole()（mongosh方法）

定义

db.dropRole( rolename, writeConcern )

从运行该方法的数据库中删除用户定义的角色。

重要

mongosh 方法

This page documents a mongosh method. This is not the documentation for database commands or language-specific drivers, such as Node.js.

有关数据库命令，请参阅 dropRole 命令。

如需了解 MongoDB API 驱动程序，请参阅特定语言的 MongoDB 驱动程序文档。

The db.dropRole() method takes the following arguments:

Parameter	类型	说明
`rolename`	字符串	要从数据库中删除的用户定义角色的名称。
`writeConcern`	文档	可选。操作的写关注级别。请参阅写关注规范。

此方法可用于以下环境中托管的部署：

重要

MongoDB Atlas 集群不支持此命令。有关 Atlas 对所有命令的支持的信息，请参阅不支持的命令。

在mongod上删除角色时，之前通过身份验证的用户仍会保持登录数据库的状态，但会立即失去该角色的权限。

在mongos上删除角色时，以前经过身份验证的用户仍保持登录数据库的状态，但在缓存刷新时会失去该角色的特权。缓存会在userCacheInvalidationIntervalSecs参数指定的时间后自动刷新，或者在运行invalidateUserCache命令时手动刷新。

If run on a replica set, db.dropRole() is executed using "majority" write concern by default.

必须对数据库执行dropRole操作才能从该数据库中删除角色。

以下操作从products数据库中删除readPrices角色：

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