Condividi tramite

SHOW GROUPS

  • Articolo

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.

Se un'entità viene specificata utilizzando WITH {USER | GROUP}, un valore booleano non null nella colonna directGroup indica l'appartenenza dell'entità.

  • TRUE: l'entità è un membro diretto del gruppo.
  • FALSE: l'entità è un membro indiretto del gruppo.

Se WITH {USER | GROUP} non viene usato, directGroup sarà NULLsempre .

Sintassi

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

Parametri

  • user_principal

    Mostra solo i gruppi che contengono l'utente specificato.

  • group_principal

    Mostra solo i gruppi che contengono il gruppo specificato.

  • regex_pattern

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

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

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