文档菜单
文档首页
/
MongoDB 手册
/
参考
/
数据库命令
/
角色管理

从数据库中删除所有角色

本页

  • 定义
  • 兼容性
  • 语法
  • 命令字段
  • 所需访问权限
  • 示例

定义

dropAllRolesFromDatabase

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

警告

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

技巧

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

辅助方法对于mongosh用户来说很方便，但它们可能不会返回与数据库命令相同级别的信息。在不需要便利性或需要额外的返回字段的情况下，请使用数据库命令。

兼容性

此命令在以下环境中部署的部署中可用

  • MongoDB Atlas：云中MongoDB部署的全托管服务

重要

此命令不支持M0、M2和M5集群。更多信息，请参阅不支持的命令。

语法

该命令具有以下语法

db.runCommand(
   {
     dropAllRolesFromDatabase: 1,
     writeConcern: { <write concern> },
     comment: <any>
   }
)

命令字段

命令包含以下字段

字段
类型
描述
从数据库中删除所有角色
整数
指定 1 以从运行命令的数据库中删除所有 用户定义 角色。
写关注
文档
/includes/source/fact-write-concern-spec-link.rst
注释
任何类型

可选。附加到此命令的用户提供的注释。一旦设置，此注释将出现在以下位置的此命令记录旁边

注释可以是任何有效的 BSON 类型（字符串、整数、对象、数组等）。

所需访问权限

您必须具有在数据库上执行 dropRole 操作 的权限，才能从该数据库中删除角色。

示例

以下操作将删除 用户定义 的所有角色从 产品 数据库

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

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

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

返回

删除角色

下一步

向角色授予特权