dropRole

在此页面上

定义

dropRole: 从运行命令的数据库中删除用户定义的角色。
提示
在 mongosh中，该命令也可以通过db.dropRole()辅助方法运行。
助手方法对于mongosh用户来说很方便，但它们返回的信息级别可能与数据库命令不同。如果不追求方便或需要额外的返回字段，请使用数据库命令。

该命令具有以下语法：

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

该命令具有以下字段：

字段	类型	说明
`dropRole`	字符串	要从数据库中删除的用户定义角色的名称。
`writeConcern`	文档	可选。操作的写关注级别。请参阅写关注规范。
`comment`	注意到	可选。用户提供的待附加到该命令的注释。设置后，该注释将与该命令的记录一起出现在以下位置： mongod 日志消息，位于 `attr.command.cursor.comment` 字段中。 `command.comment` 字段中的数据库分析器输出。 `currentOp` 输出，在 `command.comment` 字段。注释可以是任何有效的 BSON 类型（字符串、整型、对象、数组等）。

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

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

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

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

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