SHOW GROUPS

  • Статья

Область применения:проверка помечены да Databricks SQL проверка помечены да Databricks Runtime

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

Если предоставляется субъект с помощью WITH {USER | GROUP}, то отличное от NULL логическое значение в столбце 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

    Литеральное выражение STRING, которое содержит шаблон с ограниченной поддержкой регулярных выражений, используемый для фильтрации результатов инструкции.

    • * в начале и в конце шаблона сопоставляется с подстрокой.
    • * только в конце шаблона сопоставляется с началом группы.
    • | разделяет несколько регулярных выражений, каждое из которых может сопоставляться.
    • При сопоставлении шаблона регистр не учитывается.

Примеры

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