SHOW GROUPS
适用于: Databricks SQL Databricks Runtime
列出与选择性提供的正则表达式模式匹配的组。 如果不提供模式,该命令将列出系统中的所有组。 可选择提供标识符以仅显示特定用户或组所属的组。
如果使用 WITH {USER | GROUP}
提供主体,则 directGroup
列中的非空布尔值表示主体的成员身份。
TRUE
:主体是组的直接成员。FALSE
:主体是组的间接成员。
如果未使用 WITH {USER | GROUP}
,则 directGroup
将始终为 NULL
。
语法
SHOW GROUPS [ WITH USER user_principal |
WITH GROUP group_principal ]
[ [ LIKE ] regex_pattern ]
参数
-
仅显示包含指定用户的组。
-
仅显示包含指定组的组。
regex_pattern
具有有限正则表达式模式的字符串字面量,用于筛选语句结果。
*
在模式的开头和结尾与子字符串匹配。*
仅在模式的结尾与组的开头匹配。|
分隔多个正则表达式,其中的任何一个都可以匹配。- 模式匹配不区分大小写。
示例
-- Lists all groups.
> SHOW GROUPS;
name directGroup
------------ -----------
tv_alien NULL
alien NULL
californian NULL
pastafarian NULL
-- Lists groups with name containing with string pattern `rou`.
> SHOW GROUPS LIKE '*al*';
name directGroup
------------ -----------
tv_alien NULL
alien NULL
californian NULL
-- Lists groups with Alf as a member.
> SHOW GROUPS WITH USER `alf@melmak.et`;
name directGroup
------------ -----------
tv_alien true
alien false