Docs 菜单
Docs 主页
/
MongoDB Manual
/
参考
/
mongosh 方法
/
角色管理

db.dropRole()

在此页面上

  • 定义
  • 行为
  • 必需的访问权限
  • 例子

定义

db.dropRole( rolename, writeConcern )

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

重要

mongosh 方法

本页面提供 mongosh 方法的相关信息。这不是数据库命令或特定语言驱动程序（例如 Node.js）的相关文档。

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

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

db.dropRole() 方法接受以下参数：

Parameter
类型
说明
rolename
字符串
要从数据库中删除的用户定义角色的名称。
writeConcern
文档

可选。操作的写关注级别。请参阅写关注规范。

行为

身份验证

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

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

副本集(Replica Set)

如果在副本集上运行，则默认情况下使用 "majority" 写关注执行 db.dropRole()。

必需的访问权限

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

例子

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

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

后退

db.createRole

来年

db.dropAllRoles