Delen via

SHOW GROUPS

  • Artikel

Van toepassing op:vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime

Geeft een lijst weer van de groepen die overeenkomen met een optioneel opgegeven reguliere expressiepatroon. Als u geen patroon opgeeft, bevat de opdracht alle groepen in het systeem. U kunt eventueel een id opgeven om alleen de groepen weer te geven waartoe een specifieke gebruiker of groep behoort.

Als een principal wordt gebruikt WITH {USER | GROUP}, geeft een niet null Booleaanse waarde in de kolom directGroup het lidmaatschap van de principal aan.

  • TRUE: De principal is een direct lid van de groep.
  • FALSE: De principal is een indirect lid van de groep.

Als WITH {USER | GROUP} dit niet wordt gebruikt, directGroup zal dat altijd zijn NULL.

Syntaxis

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

Parameters

  • user_principal

    Alleen groepen weergeven die de opgegeven gebruiker bevatten.

  • group_principal

    Alleen groepen weergeven die de opgegeven groep bevatten.

  • regex_pattern

    Een letterlijke tekenreeks met een beperkt patroon voor reguliere expressies dat wordt gebruikt om de resultaten van de instructie te filteren.

    • * aan het begin en einde van een patroon komt overeen met een subtekenreeks.
    • * alleen aan het einde van een patroon komt overeen met het begin van een groep.
    • | scheidt meerdere reguliere expressies, die eventuele overeenkomsten kunnen hebben.
    • De patroonovereenkomst is niet hoofdlettergevoelig.

Voorbeelden

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