Partager via

SHOW GROUPS

  • Article

S’applique à : case marquée oui Databricks SQL oui coché Databricks Runtime

Répertorie les groupes correspondant à un modèle d’expression régulière fourni à titre facultatif. Si vous n’indiquez pas de modèle, liste tous les groupes du système. Vous pouvez éventuellement renseigner un identificateur pour ne faire apparaître que les groupes auxquels appartient un utilisateur ou un groupe spécifique.

Si un principal est indiqué à l’aide de WITH {USER | GROUP}, une valeur booléenne non Null dans la colonne directGroup indique l’appartenance du principal.

  • TRUE : le principal est un membre direct du groupe.
  • FALSE : le principal est un membre indirect du groupe.

Si WITH {USER | GROUP} n’est pas utilisé, directGroup est toujours NULL.

Syntaxe

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

Paramètres

  • user_principal

    Affiche uniquement les groupes qui contiennent l’utilisateur spécifié.

  • group_principal

    Affiche uniquement les groupes qui contiennent le groupe spécifié.

  • regex_pattern

    Littéral de CHAÎNE utilisant un modèle d’expression régulière limité pour filtrer les résultats de l’instruction.

    • * au début et à la fin d’un modèle correspond à une sous-chaîne.
    • * à la fin d’un modèle uniquement correspond au début d’un groupe.
    • | sépare plusieurs expressions régulières, qui peuvent toutes correspondre.
    • La correspondance du modèle n’est pas sensible à la casse.

Exemples

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