Docs 菜单
Docs 主页
/
MongoDB Manual
/ / /

db.dropRole()

在此页面上

  • 定义
  • 兼容性
  • 行为
  • 必需的访问权限
  • 例子
db.dropRole( rolename, writeConcern )

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

重要

mongosh 方法

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

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

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

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

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

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

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

  • MongoDB Enterprise:基于订阅、自我管理的 MongoDB 版本

  • MongoDB Community:源代码可用、免费使用且可自行管理的 MongoDB 版本

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

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

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

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

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

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

后退

db.createRole