Compartilhar via


SHOW GROUPS

Aplica-se a:com marcação de verificação sim Databricks SQL verificação marcada como sim Databricks Runtime

Lista os grupos que correspondem a um padrão de expressão regular fornecido opcionalmente. Se você não fornecer um padrão, o comando listará todos os grupos no sistema. Opcionalmente, você pode fornecer um identificador para mostrar apenas os grupos aos quais um usuário ou grupo específico pertence.

Para executar esse comando, é necessário ser administrador.

Sintaxe

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

Parâmetros

  • usuario_principal

    Mostra somente os grupos que contêm o usuário especificado.

  • grupo_principal

    Mostra somente os grupos que contêm o grupo especificado.

  • regex_pattern

    Um STRING literal com um padrão de expressão regular limitado usado para filtrar os resultados da instrução.

    • * no início e no final de um padrão corresponde a uma subcadeia de caracteres.
    • * somente no final de um padrão corresponde ao início de um grupo.
    • | separa várias expressões regulares, das quais qualquer uma pode corresponder.
    • A correspondência de padrões não diferencia maiúsculas de minúsculas.

RETORNA

Uma tabela com as seguintes colunas:

  • name STRING NOT NULL

    O nome do grupo.

  • directGroup BOOLEAN

    • TRUE: O diretor é um membro direto do grupo.
    • FALSE: a entidade de segurança é um membro indireto do grupo.
    • NULL: se nenhum principal tiver sido especificado.

Exemplos

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