Partilhar via

SHOW GROUPS

Aplica-se a:assinalado como Sim Databricks SQL assinalado 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, você deve ser um administrador.

Sintaxe

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

Parâmetros

  • utilizador_principal

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

  • grupo_principal

    Mostrar apenas grupos que contêm o grupo especificado.

  • regex_pattern

    Um literal STRING com um padrão de expressão regular limitado capaz de filtrar os resultados da declaração.

    • * no início e no final de um padrão faz correspondência a uma subcadeia.
    • * só no final de um padrão coincide com o 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.

DEVOLUÇÕES

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: O principal é um membro indireto do grupo.
    • NULL: Se nenhum principal foi 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
  • Last updated on