Condividi tramite


SHOW GROUPS

Si applica a:segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime

Elenca i gruppi che corrispondono a un criterio di espressione regolare fornito facoltativamente. Se non si specifica un modello, il comando elenca tutti i gruppi nel sistema. Facoltativamente, è possibile specificare un identificatore per visualizzare solo i gruppi a cui appartiene un utente o un gruppo specifico.

Per eseguire questo comando, è necessario essere un amministratore.

Sintassi

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

Parametri

  • utente_principale

    Mostra solo i gruppi che contengono l'utente specificato.

  • gruppo_principale

    Mostra solo i gruppi che contengono il gruppo specificato.

  • regex_pattern

    Un STRING letterale con un pattern di espressione regolare limitato usato per filtrare i risultati dell'istruzione.

    • * all'inizio e alla fine di un pattern che corrisponde a una sottostringa.
    • * solo alla fine di un modello corrisponde all'inizio di un gruppo.
    • | separa più espressioni regolari, una delle quali può corrispondere.
    • La corrispondenza tra modelli non fa distinzione tra maiuscole e minuscole.

RENDICONTO

Tabella con le colonne seguenti:

  • name STRING NOT NULL

    Nome del gruppo.

  • directGroup BOOLEAN

    • TRUE: Il principale è un membro diretto del gruppo.
    • FALSE: Il principale è un membro indiretto del gruppo.
    • NULL: Se non è stato specificato alcun principale.

Esempi

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