通过

SHOW GROUPS

适用于：勾选“是” Databricks SQL 勾选“是” Databricks Runtime

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

若要运行此命令，你必须是管理员。

语法

SHOW GROUPS [ WITH USER user_principal |
              WITH GROUP group_principal ]
            [ [ LIKE ] regex_pattern ]

参数

  • user_principal

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

  • 组负责人

    仅显示包含指定组的组。

  • regex_pattern

    STRING 文本，包含用于筛选语句结果的有限正则表达式模式。

    • * 在模式的开头和结尾与子字符串匹配。
    • * 仅在模式的结尾与组的开头匹配。
    • | 分隔多个正则表达式，其中的任何一个都可以匹配。
    • 模式匹配不区分大小写。

退货

具有以下列的表：

  • name STRING NOT NULL

    组的名称。

  • directGroup BOOLEAN

    • TRUE：主体是组的直接成员。
    • FALSE：主体是组的间接成员。
    • NULL：如果未指定主体。

示例

-- 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