db.getUsers()
MongoDB5.0 已于 10 月2024 结束生命周期。不再支持此版本的文档。要升级5.0 部署,请参阅 MongoDB6 。0 升级程序。
定义
db.getUsers(<options>)
返回数据库中所有用户的信息。
db.getUsers()
封装了usersInfo: 1
命令。db.getUsers()
方法可使用以下选项:db.getUsers( { showCredentials: <Boolean>, filter: <document> } ) 字段类型说明showCredentials
布尔
可选。 将该字段设置为 true 以显示用户的密码哈希值。 默认情况下,此字段为
false
。filter
文档
可选。指定
$match
阶段条件的文档,用于为符合过滤条件的用户返回信息。有关更多信息,请参阅
usersInfo
。
兼容性
此方法可用于以下环境中托管的部署:
重要
MongoDB Atlas集群不支持此命令。 有关Atlas支持所有命令的信息,请参阅不支持的命令。
MongoDB Enterprise:基于订阅、自我管理的 MongoDB 版本
MongoDB Community:源代码可用、免费使用且可自行管理的 MongoDB 版本
必需的访问权限
要查看其他用户的信息,必须对其他用户的数据库执行 viewUser
操作。
用户可查看自己的信息。
例子
查看数据库中符合指定过滤器的所有用户
db.getUsers()
方法可以接受一个 filter
文档,以返回符合过滤条件的用户信息。
要查看当前数据库中拥有 SCRAM-SHA-256
档案的所有用户:
db.getUsers({ filter: { mechanisms: "SCRAM-SHA-256" } })
查看所有用户时,可以指定 showCredentials
选项,但不能指定 showPrivileges
或 showAuthenticationRestrictions
选项。