SHOW GROUPS

Platí pro:zaškrtnuto ano Databricks SQL zaškrtnuto ano Databricks Runtime

Zobrazí seznam skupin, které odpovídají volitelně zadanému vzoru regulárního výrazu. Pokud vzor nezadáte, zobrazí příkaz seznam všech skupin v systému. Volitelně můžete zadat identifikátor, který zobrazí jenom skupiny, do nichž konkrétní uživatel nebo skupina patří.

Chcete-li spustit tento příkaz, musíte být správcem.

Syntaxe

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

Parametry

  • user_principal

    Zobrazí pouze skupiny, které obsahují zadaného uživatele.

  • hlavní_skupina

    Zobrazí pouze skupiny, které obsahují zadanou skupinu.

  • regex_pattern

    Literál STRING, který má omezený vzor regulárního výrazu použitý k filtrování výsledků příkazu.

    • * na začátku a konci vzoru odpovídá podřetězdci.
    • * pouze na konci vzoru odpovídá začátku skupiny.
    • | odděluje více regulárních výrazů, z nichž každá se může shodovat.
    • Porovnávání vzorů nerozlišuje malá a velká písmena.

NÁVRATY

Tabulka s následujícími sloupci:

  • name STRING NOT NULL

    Název skupiny.

  • directGroup BOOLEAN

    • TRUE: Hlavní subjekt je přímým členem skupiny.
    • FALSE: Objekt je nepřímým členem skupiny.
    • NULL: Pokud nebyl zadán žádný hlavní.

Příklady

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