sp_helpgroup (Transact-SQL)

Article
12/15/2008

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

Important :
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.

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