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

dropAllRolesFromDatabase

在此页面上

  • 定义
  • 兼容性
  • 语法
  • 命令字段
  • 必需的访问权限
  • 例子
dropAllRolesFromDatabase

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

警告

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

提示

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

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

此命令可用于以下环境中托管的部署:

  • MongoDB Atlas:用于云中 MongoDB 部署的完全托管服务

重要

M 0 、M 2和 M 5集群不支持此命令。 有关更多信息,请参阅不支持的命令。

该命令具有以下语法:

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

该命令具有以下字段:

字段
类型
说明
dropAllRolesFromDatabase
整型
指定1以从运行该命令的数据库中删除所有用户定义的角色。
writeConcern
文档
/includes/source/fact-写关注(write concern)-spec-link.rst
comment
any

可选。用户提供的待附加到该命令的注释。设置后,该注释将与该命令的记录一起出现在以下位置:

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

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

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

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

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

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

后退

dropRole