Поделиться через

SHOW GROUPS

Область применения:флажок Databricks SQL флажок Databricks Runtime

Список групп, которые соответствуют дополнительно указанному шаблону регулярного выражения. Если шаблон не указан, команда выводит список всех групп в системе. При необходимости можно указать идентификатор для отображения только групп, к которому принадлежит конкретный пользователь или группа.

Для выполнения этой команды требуются права администратора.

Синтаксис

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

Параметры

  • user_principal

    Отображает только те группы, которые содержат указанного пользователя.

  • group_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 `[email protected]`;
         name directGroup
 ------------ -----------
     tv_alien        true
        alien       false