sp_changegroup (Transact-SQL)

Modifie l'appartenance à un rôle d'un utilisateur dans la base de données active.

Remarque :
sp_changegroup est fourni pour des raisons de compatibilité avec les versions antérieures de Microsoft SQL Server. Dans les nouveaux développements, utilisez plutôt sp_addrolemember et sp_droprolemember.

Conventions de syntaxe Transact-SQL

Syntaxe

sp_changegroup [ @grpname= ] 'role' 
     , [ @username = ] 'user'

Arguments

• [ @grpname = ] 'role'
  Rôle auquel est ajouté l'utilisateur. role est de type sysname, sans valeur par défaut. role doit exister dans la base de données active.

• [ @username = ] 'user'
  Utilisateur à ajouter au rôle. user est de type sysname, sans valeur par défaut. L'utilisateur doit déjà exister dans la base de données active.

Valeurs des codes de retour

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

Notes

Les rôles constituent un mécanisme permettant de gérer les autorisations appliquées à leurs membres. L'ajout d'un utilisateur à un rôle permet à cet utilisateur d'acquérir les autorisations accordées au rôle.

Lorsque sp_changegroup est exécuté, le compte de sécurité de user est ajouté en tant que membre de role et supprimé de tous les autres rôles. Pour modifier l'appartenance au rôle sans affecter l'appartenance aux autres rôles, utilisez sp_addrolemember et sp_droprolemember.

Il est possible d'affecter de nouveaux utilisateurs de base de données aux rôles au moment où leur est accordé l'accès à la base de données à l'aide de sp_adduser.

Chaque utilisateur est membre du rôle par défaut public.

sp_changegroup ne peut pas être exécuté dans une transaction définie par l'utilisateur.

Autorisations

L'une des autorisations suivantes est requise : appartenance au rôle de base de données fixe db_owner ; appartenance au rôle de base de données fixe db_securityadmin ; appartenance au rôle propriétaire du rôle ; autorisation ALTER sur le rôle.

Exemples

Le code exemple suivant fait de l'utilisateur Albert un membre du rôle developers.

EXEC sp_changegroup 'developers', 'Albert'

Voir aussi

Référence

Procédures stockées liées à la sécurité (Transact-SQL)
sp_addrole (Transact-SQL)
sp_addrolemember (Transact-SQL)
sp_adduser (Transact-SQL)
sp_dropgroup (Transact-SQL)
sp_helpgroup (Transact-SQL)
Procédures stockées système (Transact-SQL)

Aide et Informations

Assistance sur SQL Server 2005