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