Dela via

SHOW GROUPS

  • Artikel

Gäller för:markerad ja Databricks SQL markerad ja Databricks Runtime

Visar en lista över de grupper som matchar ett mönster för reguljära uttryck som kan anges. Om du inte anger något mönster listar kommandot alla grupper i systemet. Du kan också ange en identifier för att endast visa de grupper som en specifik användare eller grupp tillhör.

Om en huvudperson anges med hjälp av WITH {USER | GROUP}, anger ett icke-null booleskt värde i columndirectGroup huvudpersonens medlemskap.

  • TRUE: Huvudkontot är en direkt medlem i gruppen.
  • FALSE: Huvudkontot är en indirekt medlem i gruppen.

Om WITH {USER | GROUP} inte används directGroup , kommer alltid att vara NULL.

Syntax

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

Parameters

  • user_principal

    Visa endast grupper som innehåller den angivna användaren.

  • group_principal

    Visa endast grupper som innehåller den angivna gruppen.

  • regex_pattern

    En STRING-literal med ett begränsat mönster för reguljära uttryck som används för att filtrera resultatet av -instruktionen.

    • * i början och slutet av ett mönster matchar på en delsträng.
    • * endast i slutet av ett mönster matchar början av en grupp.
    • | avgränsar flera reguljära uttryck, som alla kan matcha.
    • Mönstermatchningen är skiftlägeskänslig.

Exempel

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