dropRole
定义
dropRole
从运行该命令的数据库中删除用户定义的角色。
提示
在
mongosh
中,还可以通过db.dropRole()
辅助方法运行此命令。辅助方法对
mongosh
用户来说很方便,但它们返回的信息级别可能与数据库命令不同。如果不追求方便或需要额外的返回字段,请使用数据库命令。dropRole
命令使用以下语法:{ dropRole: "<role>", writeConcern: { <write concern> }, comment: <any> } dropRole
命令拥有以下字段:字段类型说明dropRole
字符串要从数据库中删除的用户定义角色的名称。writeConcern
文档comment
任何可选。用户提供的待附加到该命令的注释。设置后,该注释将与该命令的记录一起出现在以下位置:
mongod 日志消息,位于
attr.command.cursor.comment
字段中。command.comment
字段中的数据库分析器输出。currentOp
输出,在command.comment
字段。
注释可以是任何有效的 BSON 类型(字符串、整型、对象、数组等)。
行为
身份验证
在mongod
上删除角色时,之前通过身份验证的用户仍会保持登录数据库的状态,但会立即失去该角色的权限。
在mongos
上删除角色时,以前经过身份验证的用户仍保持登录数据库的状态,但在缓存刷新时会失去该角色的特权。 缓存会在userCacheInvalidationIntervalSecs
参数指定的时间后自动刷新,或者在运行invalidateUserCache
命令时手动刷新。
必需的访问权限
例子
以下操作从products
数据库中删除readPrices
角色:
use products db.runCommand( { dropRole: "readPrices", writeConcern: { w: "majority" } } )