Partager via


sp_helpgroup (Transact-SQL)

Affiche des informations sur un rôle, ou sur tous les rôles, de la base de données active.

ms188925.note(fr-fr,SQL.90).gifImportant :
sp_helpgroup offre la compatibilité avec les versions antérieures de SQL Server. Cette fonctionnalité sera supprimée dans la prochaine version de Microsoft SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement, et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité. Utilisez plutôt la vue de catalogue sys.database_principals.

Icône Lien de rubriqueConventions de syntaxe Transact-SQL

Syntaxe

sp_helpgroup [ [ @grpname = ] 'role' ]

Arguments

  • [ @grpname = ] 'role'
    Nom d'un rôle. role doit exister dans la base de données active. role est de type sysname. Sa valeur par défaut est NULL. Si role est spécifié, des informations sur le nom et les membres du rôle sont renvoyées ; dans le cas contraire, des informations sur tous les rôles de la base de données active sont renvoyées.

Valeurs des codes de retour

0 (succès) ou 1 (échec)

Notes

Pour afficher les autorisations associées à un rôle, utilisez sp_helprotect.

Autorisations

Nécessite l'appartenance au rôle public.

Ensembles de résultats

Si vous ne spécifiez pas l'argument role, les informations suivantes sont renvoyées pour tous les rôles.

Nom de la colonne Type de données Description

group_name

sysname

Nom du rôle dans la base de données active.

group_id

smallint

ID du rôle dans la base de données active.

Si vous spécifiez l'argument role, les informations suivantes sont renvoyées.

Nom de la colonne Type de données Description

group_name

sysname

Nom du rôle dans la base de données active.

group_id

smallint

ID du rôle dans la base de données active.

users_in_group

sysname

Membre du rôle dans la base de données active.

userid

smallint

ID de l'utilisateur du membre du rôle.

Exemples

A. Renvoi d'informations sur un seul rôle.

La requête suivante renvoie des informations sur le rôle SammamishShippers.

EXEC sp_helpgroup 'SammamishShippers'

B. Renvoi d'informations sur tous les rôles

Le code exemple suivant renvoie des informations sur tous les rôles dans la base de données active.

EXEC sp_helpgroup

Voir aussi

Référence

Procédures stockées du moteur de base de données (Transact-SQL)
sys.database_principals (Transact-SQL)
sp_helprotect (Transact-SQL)
sp_helprole (Transact-SQL)
sp_helpuser (Transact-SQL)
Procédures stockées système (Transact-SQL)

Aide et Informations

Assistance sur SQL Server 2005