dropAllRolesFromDatabase

定义

dropAllRolesFromDatabase

删除运行命令的数据库上的所有用户定义角色。

警告

dropAllRolesFromDatabase会从数据库中删除所有用户定义的角色。

提示

在mongosh中，该命令也可以通过db.dropAllRoles()辅助方法运行。

助手方法对于mongosh用户来说很方便，但它们返回的信息级别可能与数据库命令不同。如果不追求方便或需要额外的返回字段，请使用数据库命令。

dropAllRolesFromDatabase命令采用以下形式：

{
  dropAllRolesFromDatabase: 1,
  writeConcern: { <write concern> },
  comment: <any>
}

该命令具有以下字段：

字段	类型	说明
dropAllRolesFromDatabase	整型	指定1以从运行该命令的数据库中删除所有用户定义的角色。
writeConcern	文档	/includes/source/fact-写关注（write concern）-spec-link.rst
comment	注意到	可选。用户提供的待附加到该命令的注释。设置后，该注释将与该命令的记录一起出现在以下位置： mongod 日志消息，位于 attr.command.cursor.comment 字段中。 command.comment 字段中的数据库分析器输出。 currentOp 输出，在 command.comment 字段。 注释可以是任何有效的 BSON 类型（字符串、整型、对象、数组等）。

必需的访问权限

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

例子

以下操作会从products数据库中删除所有用户定义的角色：

use products
db.runCommand(
   {
     dropAllRolesFromDatabase: 1,
     writeConcern: { w: "majority" }
   }
)

结果文档中的n字段报告删除的角色数量：

{ "n" : 4, "ok" : 1 }