sp_grantdbaccess (Transact-SQL)
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 = ] N'loginame'
[ , [ @name_in_db = ] N'name_in_db' OUTPUT ]
[ ; ]
Arguments
[ @loginame = ] N’loginame'
Nom du groupe Windows, de la connexion Windows ou de la connexion SQL Server à mapper au nouvel utilisateur de base de données. @loginame est sysname, sans valeur par défaut. Les noms des groupes Windows et des connexions Windows doivent être qualifiés avec un nom de domaine Windows au format <domain>\<login>
; par exemple. LONDON\Joeb
La connexion ne peut pas déjà être mappée à un utilisateur dans la base de données.
[ @name_in_db = ] SORTIE N’name_in_db'
Nom de l’utilisateur de la nouvelle base de données. @name_in_db est un paramètre OUTPUT de type sysname. S’il n’est pas spécifié, @loginame est utilisé. Si elle est spécifiée en tant que variable OUTPUT avec la valeur NULL
, @name_in_db est définie sur @loginame. @name_in_db ne doit pas déjà exister dans la base de données active.
Valeurs des codes de retour
0
(réussite) or 1
(échec).
Notes
sp_grantdbaccess
appels CREATE USER
, qui prennent en charge des options supplémentaires. Pour plus d’informations sur la création d’utilisateurs de base de données, consultez CREATE USER. 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 le compte Edmonds\LolanSo
Windows à la base de données active, qui est la méthode préférée pour créer un utilisateur de base de données. Le nouvel utilisateur se nomme Lolan
.
CREATE USER Lolan FOR LOGIN [Edmonds\LolanSo];
GO