SHOW USERS

列出系统中的所有用户。

另请参阅：

CREATE USER、ALTER USER、DROP USER、DESCRIBE USER

语法

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 |
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' 所返回行的行。

例如：

  • ... STARTS WITH 'A' LIMIT ... FROM 'B' 不会返回任何结果。

  • ... STARTS WITH 'B' LIMIT ... FROM 'A' 不会返回任何结果。

  • ... STARTS WITH 'A' LIMIT ... FROM 'AB' 将返回结果（如果有任何行与输入字符串匹配）。

使用说明

  • 任何用户都可以执行 SHOW USERS 命令。Snowflake 根据授予用户用于运行命令的 活跃角色 的权限筛选输出。运行该命令的用户始终可以在结果中看到用户名，该用户名记录在 name 列中。要查看全部输出，活跃角色必须具有以下权限之一：

    • 用户对象的 OWNERSHIP 权限。

    • 账户的 MANAGE GRANTS 权限。

  • 如果账户的用户数量超过 10000 个，则可以使用以下任一选项：

    • SHOW USERS;

    • SHOW USERS LIMIT 10000 FROM 'JOE';

      返回 10000 名之后的用户。在此示例中，JOE 是命令中最后一行的用户名。

  • 该命令不需要正在运行的仓库即可执行。

  • 若要对此命令的输出进行后处理，可以使用 RESULT_SCAN 函数，该函数会将输出视为可查询的表。

语言: 中文