Partager via

SHOW GROUPS

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 ne fournissez pas de modèle, la commande répertorie 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.

Pour exécuter cette commande, vous devez être administrateur.

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 STRING avec un modèle d’expression régulière limité utilisé pour filtrer les résultats de la déclaration.

    • * 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.

RETOURS

Tableau avec les colonnes suivantes :

  • name STRING NOT NULL

    Nom du groupe.

  • directGroup BOOLEAN

    • TRUE : le principal est un membre direct du groupe.
    • FALSE : le principal est un membre indirect du groupe.
    • NULL: Si aucun principal n’a été spécifié.

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