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 ]

参数

  • user_principal

    仅显示包含指定用户的组。

  • group_principal

    仅显示包含指定组的组。

  • 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