定义
dropUser从运行命令的数据库中删除用户。
提示
In
mongosh, this command can also be run through thedb.dropUser()helper method.Helper methods are convenient for
mongoshusers, but they may not return the same level of information as database commands. In cases where the convenience is not needed or the additional return fields are required, use the database command.
兼容性
此命令可用于以下环境中托管的部署:
MongoDB Enterprise:基于订阅、自我管理的 MongoDB 版本
MongoDB Community:源代码可用、免费使用且可自行管理的 MongoDB 版本
重要
MongoDB Atlas 集群不支持此命令。有关 Atlas 对所有命令的支持的信息,请参阅不支持的命令。
语法
该命令具有以下语法:
db.runCommand( { dropUser: "<user>", writeConcern: { <write concern> }, comment: <any> } )
命令字段
该命令具有以下字段:
字段 | 类型 | 说明 |
|---|---|---|
| 字符串 | 要删除的用户的名称。使用用户所在的数据库时,必须发出 |
| 文档 | |
| any | 可选。用户提供的待附加到该命令的注释。设置后,该注释将与该命令的记录一起出现在以下位置:
注释可以是任何有效的 BSON 类型(字符串、整型、对象、数组等)。 |
在删除具有 userAdminAnyDatabase 角色的用户之前,确保至少有另一个用户具有用户管理特权。
必需的访问权限
例子
mongoshreportUser1中的以下操作序列会从products 数据库中删除 :
use products db.runCommand( { dropUser: "reportUser1", writeConcern: { w: "majority", wtimeout: 5000 } } )