Partilhar via

MOSTRAR GRUPOS

  • Artigo

Aplica-se a: Marque Sim Databricks SQL Marque 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.

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

  • TRUE: O diretor é um membro direto do grupo.
  • FALSE: O comitente é um membro indireto do grupo.

Se WITH {USER | GROUP} não for utilizado, directGroup será NULLsempre .

Sintaxe

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

Parâmetros

  • user_principal

    Mostrar apenas grupos que contêm o usuário especificado.

  • group_principal

    Mostrar apenas grupos que contêm o grupo especificado.

  • regex_pattern

    Um literal 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, qualquer uma das quais pode corresponder.
    • A correspondência de padrão 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