usersInfo (database command数据库命令)

View Specific Users查看特定用户

To see information and privileges, but not the credentials, for the user "Kari" defined in "home" database, run the following command:要查看"home"数据库中定义的用户"Kari"的信息和权限，但不查看凭据，请运行以下命令：

db.runCommand(
   {
     usersInfo:  { user: "Kari", db: "home" },
     showPrivileges: true
   }
)

To view a user that exists in the current database, you can specify the user by name only. For example, if you are in the home database and a user named "Kari" exists in the home database, you can run the following command:要查看当前数据库中存在的用户，只能按名称指定用户。例如，如果您在home数据库中，并且home数据库中存在名为"Kari"的用户，则可以运行以下命令：

db.getSiblingDB("home").runCommand(
   {
     usersInfo:  "Kari",
     showPrivileges: true
   }
)

View Multiple Users查看多个用户

To view info for several users, use an array, with or without the optional fields showPrivileges and showCredentials. For example:要查看多个用户的信息，请使用数组，可以带或不带可选字段showPrivileges和showCredentials。例如：

db.runCommand( {
   usersInfo: [ { user: "Kari", db: "home" }, { user: "Li", db: "myApp" } ],
   showPrivileges: true
} )

View All Users for a Database查看数据库的所有用户

To view all users on the database the command is run, use a command document that resembles the following:要查看运行命令的数据库上的所有用户，请使用类似于以下内容的命令文档：

db.runCommand( { usersInfo: 1 } )

When viewing all users, you can specify the showCredentials option but not the showPrivileges or the showAuthenticationRestrictions options.查看所有用户时，可以指定showCredentials选项，但不能指定showPrivileges或showAuthenticationRestrictions选项。

View All Users for a Database that Match the Specified Filter查看与指定筛选器匹配的数据库的所有用户

The usersInfo command can accept a filter document to return information for users that match the filter condition.usersInfo命令可以接受filter文档，为符合筛选条件的用户返回信息。

To view all users in the current database who have the specified role, use a command document that resembles the following:要查看当前数据库中具有指定角色的所有用户，请使用类似于以下内容的命令文档：

db.runCommand( { usersInfo: 1, filter: { roles: { role: "root", db: "admin" } } } )

When viewing all users, you can specify the showCredentials option but not the showPrivileges or the showAuthenticationRestrictions options.查看所有用户时，可以指定showCredentials选项，但不能指定showPrivileges或showAuthenticationRestrictions选项。

View All Users with SCRAM-SHA-1 Credentials查看所有拥有SCRAM-SHA-1凭据的用户

The usersInfo command can accept a filter document to return information for users that match the filter condition.usersInfo命令可以接受筛选文档，为符合filter条件的用户返回信息。

The following operation returns all users that have SCRAM-SHA-1 credentials. Specifically, the command returns all users across all databases and then uses the $match stage to apply the specified filter to the users.以下操作返回具有SCRAM-SHA-1凭据的所有用户。具体来说，该命令返回所有数据库中的所有用户，然后使用$match阶段将指定的筛选器应用于用户。

db.runCommand( { usersInfo: { forAllDBs: true}, filter: { mechanisms: "SCRAM-SHA-1" } } )

When viewing all users, you can specify the showCredentials option but not the showPrivileges or the showAuthenticationRestrictions options.查看所有用户时，可以指定showCredentials选项，但不能指定showPrivileges或showAuthenticationRestrictions选项。

Omit Custom Data from Output从输出中省略自定义数据

Use the createUser command to create a user named accountAdmin01 on the products database:使用createUser命令在products数据库上创建名为accountAdmin01的用户：

db.getSiblingDB("products").runCommand( {
   createUser: "accountAdmin01",
   pwd: passwordPrompt(),
   customData: { employeeId: 12345 },
   roles: [ { role: 'readWrite', db: 'products' } ]
} )

The user contains a customData field of { employeeId: 12345 }.用户包含{ employeeId: 12345 }的customData字段。

To retrieve the user but omit the custom data from the output, run usersInfo with showCustomData set to false:要检索用户但从输出中省略自定义数据，请运行usersInfo并将showCustomData设置为false：

db.getSiblingDB("products").runCommand ( {
   usersInfo: "accountAdmin01",
   showCustomData: false
} )

Example output:示例输出：

{
   users: [
      {
         _id: 'products.accountAdmin01',
         userId: UUID("0955afc1-303c-4683-a029-8e17dd5501f4"),
         user: 'accountAdmin01',
         db: 'products',
         roles: [ { role: 'readWrite', db: 'products' } ],
         mechanisms: [ 'SCRAM-SHA-1', 'SCRAM-SHA-256' ]
      }
   ],
   ok: 1
}