Freigeben über


SHOW GROUPS

Gilt für: durch Häkchen mit „Ja“ markiert Databricks SQL Häkchen gesetzt ja Databricks Runtime

Listet die Gruppen auf, die einem optional angegebenen regulären Ausdrucksmuster entsprechen. Wenn Sie kein Muster angegeben haben, listet der Befehl alle Gruppen im System auf. Optional können Sie einen Bezeichner bereitstellen, um nur die Gruppen anzuzeigen, zu denen ein bestimmter Benutzer oder eine bestimmte Gruppe gehört.

Wenn ein Prinzipal mit WITH {USER | GROUP} bereitgestellt wird, gibt ein boolescher Wert ungleich NULL in der Spalte directGroup die Mitgliedschaft des Prinzipals an.

  • TRUE: Der Prinzipal ist ein direktes Mitglied der Gruppe.
  • FALSE: Der Prinzipal ist ein indirektes Mitglied der Gruppe.

Wenn WITH {USER | GROUP} nicht verwendet wird, ist directGroup immer NULL.

Syntax

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

Parameter

  • user_principal

    Zeigt nur Gruppen an, die den angegebenen Benutzer enthalten.

  • group_principal

    Zeigt nur Gruppen an, die die angegebene Gruppe enthalten.

  • regex_pattern

    Ein Zeichenfolgenliteral mit einem eingeschränkten regulären Ausdrucksmuster, das zum Filtern der Ergebnisse der Anweisung verwendet wird.

    • * am Anfang und Ende eines Musters entspricht einer Teilzeichenfolge.
    • * nur am Ende eines Musters entspricht dem Anfang einer Gruppe.
    • | trennt mehrere reguläre Ausdrücke, von denen jeder übereinstimmen kann.
    • Bei der Musterübereinstimmung wird keine Groß-/Kleinschreibung beachtet.

Beispiele

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