SHOW USERS¶

列出系统中的所有用户。

语法¶

SHOW [ TERSE ] USERS
[ LIKE '<pattern>' ]
[ STARTS WITH '<name_string>' ]
[ LIMIT <rows> ]
[ FROM '<name_string>' ]

Copy

TERSE

（可选）仅返回输出列的子集：

| name | created_on | display_name | first_name | last_name | email | org_identity | comment | has_password | has_rsa_public_key | type | has_mfa

Copy

默认：无值（所有列都包含在输出中）。

LIKE 'pattern'

（可选）按对象名称筛选命令输出。筛选器使用不区分大小写的模式匹配，并支持 SQL 通配符（% 和 _）。

例如，以下模式返回相同的结果：

... LIKE '%testing%' ...

... LIKE '%TESTING%' ...

. 默认：无值（不对输出应用筛选）。

STARTS WITH 'name_string'

（可选）根据对象名称开头显示的字符筛选命令输出。该字符串必须放在单引号内并且区分大小写。

例如，以下字符串会返回不同的结果：

... STARTS WITH 'B' ...

... STARTS WITH 'b' ...

. 默认：无值（不对输出应用筛选）

LIMIT rows [ FROM 'name_string' ]

（可选）限制返回的最大行数，同时还对结果启用“分页”功能。返回的实际行数可能小于指定的限制。例如，现有对象的数量小于指定的限制。

可选的 FROM 'name_string' 分子句实际上会充当结果的“游标”。这样就可以提取对象名称与指定字符串匹配的第一行之后的指定行数：

默认：无值（不对输出应用限制）

备注

对于支持 FROM 'name_string' 和 STARTS WITH 'name_string' 的 SHOW 子句，您可以将这两个子句组合在同一语句中。但是，两个条件都必须满足，否则它们相互抵消，不返回任何结果。

此外，对象按名称的字典顺序返回，因此 FROM 'name_string' 仅返回字典值高于 STARTS WITH 'name_string' 所返回行的行。

例如：

任何用户都可以执行 SHOW USERS 命令。Snowflake 根据授予用户用于运行命令的活跃角色的权限筛选输出。运行该命令的用户始终可以在结果中看到用户名，该用户名记录在 name 列中。要查看全部输出，活跃角色必须具有以下权限之一：
- 用户对象的 OWNERSHIP 权限。
- 账户的 MANAGE GRANTS 权限。
如果账户的用户数量超过 10000 个，则可以使用以下任一选项：
- SHOW USERS;
- SHOW USERS LIMIT 10000 FROM 'JOE';
  
  返回 10000 名之后的用户。在此示例中，JOE 是命令中最后一行的用户名。

该命令不需要正在运行的仓库即可执行。
该命令仅返回当前用户的当前角色已获授至少一项访问权限的对象。
MANAGE GRANTS 访问权限隐式允许其持有者查看账户中的每个对象。默认情况下，只有账户管理员（具有 ACCOUNTADMIN 角色的用户）和安全管理员（具有 SECURITYADMIN 角色的用户）才具有 MANAGE GRANTS 权限。