dropAllRolesFromDatabase
定义
dropAllRolesFromDatabase
删除运行命令的数据库上的所有用户定义角色。
警告
dropAllRolesFromDatabase
会从数据库中删除所有用户定义的角色。提示
在
mongosh
中,该命令也可通过db.dropAllRoles()
辅助方法运行。辅助方法对
mongosh
用户来说很方便,但它们返回的信息级别可能与数据库命令不同。如果不追求方便或需要额外的返回字段,请使用数据库命令。
兼容性
此命令可用于以下环境中托管的部署:
MongoDB Atlas:用于云中 MongoDB 部署的完全托管服务
重要
M 0 、M 2和 M 5集群不支持此命令。 有关更多信息,请参阅不支持的命令。
MongoDB Enterprise:基于订阅、自我管理的 MongoDB 版本
MongoDB Community:源代码可用、免费使用且可自行管理的 MongoDB 版本
语法
该命令具有以下语法:
db.runCommand( { dropAllRolesFromDatabase: 1, writeConcern: { <write concern> }, comment: <any> } )
命令字段
该命令具有以下字段:
字段 | 类型 | 说明 |
---|---|---|
dropAllRolesFromDatabase | 整型 | 指定 1 以从运行该命令的数据库中删除所有用户定义的角色。 |
writeConcern | 文档 | /includes/source/fact-写关注(write concern)-spec-link.rst |
comment | any | 可选。用户提供的待附加到该命令的注释。设置后,该注释将与该命令的记录一起出现在以下位置:
注释可以是任何有效的 BSON 类型(字符串、整型、对象、数组等)。 |
必需的访问权限
例子
以下操作会从products
数据库中删除所有用户定义的角色:
use products db.runCommand( { dropAllRolesFromDatabase: 1, writeConcern: { w: "majority" } } )
结果文档中的n
字段报告删除的角色数量:
{ "n" : 4, "ok" : 1 }