SHOW GROUPS

  • 项目

适用于：check marked yes Databricks SQL check marked yes Databricks Runtime 8.3 及更高版本

列出与选择性提供的正则表达式模式匹配的组。 如果不提供模式，该命令将列出系统中的所有组。 可选择提供标识符以仅显示特定用户或组所属的组。

如果使用 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