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 angeben, 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.

Um diesen Befehl auszuführen, müssen Sie ein Administrator sein.

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.

  • Gruppenvorstand

    Zeigt nur Gruppen an, die die angegebene Gruppe enthalten.

  • regex_pattern

    Ein STRING Literal mit einem begrenzten Muster für reguläre Ausdrücke, 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.

RÜCKSENDUNGEN

Eine Tabelle mit den folgenden Spalten:

  • name STRING NOT NULL

    Der Name der Gruppe.

  • directGroup BOOLEAN

    • TRUE: Der Prinzipal ist ein direktes Mitglied der Gruppe.
    • FALSE: Der Prinzipal ist ein indirektes Mitglied der Gruppe.
    • NULL: Wenn kein Prinzipal angegeben wurde.

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
  • Last updated on