Sdílet prostřednictvím

SHOW GROUPS

  • Článek

Platí pro:zaškrtnutí označeného ano Databricks SQL zaškrtnutí označeného 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 identifier, aby se zobrazily jenom skupiny, do nichž konkrétní uživatel nebo skupina patří.

Pokud je objekt zabezpečení poskytnut pomocí WITH {USER | GROUP}, logická hodnota, která není null, v columndirectGroup indikuje členství objektu zabezpečení.

  • TRUE: Objekt zabezpečení je přímým členem skupiny.
  • FALSE: Objekt zabezpečení je nepřímým členem skupiny.

Pokud WITH {USER | GROUP} se nepoužívá, directGroup bude vždy NULL.

Syntaxe

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

Parameters

  • user_principal

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

  • group_principal

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

  • regex_pattern

    Literál STRING s omezeným vzorem regulárního výrazu použitým 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.

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