Compartilhar via

SHOW GROUPS

  • Artigo

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

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

Se uma entidade de segurança for fornecida usando WITH {USER | GROUP}, um valor booliano não nulo na coluna directGroup indicará a associação da entidade de segurança.

  • TRUE: a entidade de segurança é um membro direto do grupo.
  • FALSE: a entidade de segurança é um membro indireto do grupo.

Se WITH {USER | GROUP} não for usado, directGroup sempre será NULL.

Sintaxe

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

Parâmetros

  • user_principal

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

  • group_principal

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

  • regex_pattern

    Um literal de STRING 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 substring.
    • * 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.

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