sp_grantdbaccess (Transact-SQL)

  • Article

S’applique à :SQL Server

Ajoute un utilisateur à la base de données active.

Important

Cette fonctionnalité sera supprimée dans une version future de 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 CREATE USER à la place.

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_grantdbaccess [ @loginame = ] 'login'  
    [ , [ @name_in_db = ] 'name_in_db' [ OUTPUT ] ]

Arguments

[ @loginame = ] 'login_ ' Nom du groupe Windows, de la connexion Windows ou de la connexion SQL Server à mapper au nouvel utilisateur de base de données. Les noms des groupes Windows et des connexions Windows doivent être qualifiés avec un nom de domaine Windows dans le formulaire Connexion de domaine\ ; par exemple, LONDON\Joeb. La connexion ne peut pas être déjà associée à un utilisateur de la base de données. login est un nom sysname, sans valeur par défaut.

[ @name_in_db = ] 'name_in_db' [ OUTPUT] Nom du nouvel utilisateur de base de données. name_in_db est une variable OUTPUT avec un type de données sysname et une valeur par défaut NULL. S’il n’est pas spécifié, la connexion est utilisée. Si elle est spécifiée en tant que variable OUTPUT avec la valeur NULL, @name_in_db est définie sur la connexion. name_in_db ne doit pas déjà exister dans la base de données active.

Codet de retour

0 (réussite) ou 1 (échec)

Notes

sp_grantdbaccess appelle CREATE USER, qui prend en charge des options supplémentaires. Pour plus d’informations sur la création d’utilisateurs de base de données, consultez CREATE USER (Transact-SQL). Pour supprimer un utilisateur de base de données d’une base de données, utilisez DROP USER.

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

Autorisations

Nécessite l’appartenance au rôle de base de données fixe db_owner ou au rôle de base de données fixe db_accessadmin .

Exemples

L’exemple suivant utilise CREATE USER pour ajouter un utilisateur de base de données pour la connexion Edmonds\LolanSo Windows à la base de données active. Le nouvel utilisateur se nomme Lolan. Il s'agit de la méthode recommandée pour la création d'un utilisateur de base de données.

CREATE USER Lolan FOR LOGIN [Edmonds\LolanSo];  
GO

Voir aussi

Procédures stockées liées à la sécurité (Transact-SQL)
CRÉER UN UTILISATEUR (Transact-SQL)
DROP USER (Transact-SQL)
Procédures stockées système (Transact-SQL)