SHOW GROUPS (Databricks SQL)

Az opcionálisan megadott reguláris kifejezésmintának megfelelő csoportokat sorolja fel. Ha nem ad meg mintát, a parancs felsorolja a rendszer összes csoportját. Megadhat egy azonosítót, amely csak azokat a csoportokat jeleníti meg, amelyekhez egy adott felhasználó vagy csoport tartozik.

Ha egy rendszerbiztonsági tagot használ WITH {USER | GROUP}, az oszlopban directGroup lévő nem null logikai érték jelzi a tag tagságát.

  • TRUE: A rendszerbiztonsági tag a csoport közvetlen tagja.
  • FALSE: A tag a csoport közvetett tagja.

Ha WITH {USER | GROUP} nincs használatban, directGroup mindig az lesz NULL.

Szintaxis

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

Paraméterek

  • user_principal

    Csak a megadott felhasználót tartalmazó csoportok megjelenítése.

  • group_principal

    Csak a megadott csoportot tartalmazó csoportok megjelenítése.

  • regex_pattern

    Sztringkonstans korlátozott reguláris kifejezésmintával az utasítás eredményeinek szűréséhez.

    • * a minta elején és végén megegyezik egy részsztringen.
    • * csak egy minta végén egyezik egy csoport elejével.
    • | több reguláris kifejezést választ el egymástól, amelyek bármelyike megegyezhet.
    • A mintaegyezés megkülönbözteti a kis- és nagybetűket.

Példák

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