sp_grantdbaccess (Transact-SQL)

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

Important

Cette fonctionnalité sera supprimée dans une 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 CREATE USER.

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

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

Arguments

  • [ @loginame = ] **'**login '
    Nom du groupe Windows, de la connexion d'accès Windows ou de la connexion d'accès SQL Server à associer au nouvel utilisateur de la base de données. Les noms des groupes Windows et des connexions d'accès Windows doivent être qualifiés par un nom de domaine Windows, au format Domain\login ; par exemple, LONDON\Joeb. La connexion ne peut pas être déjà associée à un utilisateur de la base de données. login est de type sysname et n'a pas de valeur par défaut.

  • [ @name_in_db=] 'name_in_db' [ OUTPUT]
    Nom du nouvel utilisateur de la base de données. name_in_db est une variable OUTPUT dont le type de données est sysname et la valeur par défaut NULL. Si cet argument n'est pas spécifié, login est utilisé. Si cet argument est spécifié en tant que variable OUTPUT de valeur NULL, @name_in_db prend la valeur login. name_in_db ne doit pas déjà exister dans la base de données active.

Valeurs des codes de retour

0 (succès) 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 d'une base de données, utilisez DROP USER.

Il n'est pas possible d'exécuter sp_grantdbaccess 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.

Exemple

L'exemple suivant utilise CREATE USER pour ajouter à la base de données active un utilisateur associé à la connexion Windows Edmonds\LolanSo 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