sys.sp_grantdbaccess (Transact-SQL)

Gilt für:SQL Server

Fügt der aktuellen Datenbank einen Datenbankbenutzer hinzu.

Wichtig

Diese Funktion wird in einer zukünftigen Version von SQL Serverentfernt. Nutzen Sie diese Funktionen bei Neuentwicklungen nicht mehr, und planen Sie die Änderung von Anwendungen, die diese Funktion zurzeit verwenden. Verwenden Sie stattdessen CREATE USER.

Transact-SQL-Syntaxkonventionen

Syntax

sys.sp_grantdbaccess
    [ @loginame = ] N'loginame'
    [ , [ @name_in_db = ] N'name_in_db' OUTPUT ]
[ ; ]

Argumente

[ @loginame = ] N'loginame'

Der Name der Windows-Gruppe, der Windows-Anmeldung oder der SQL Server-Anmeldung, die dem neuen Datenbankbenutzer zugeordnet werden soll. @loginame ist "sysname" ohne Standard. Namen von Windows-Gruppen und Windows-Anmeldungen müssen mit einem Windows-Domänennamen im Formular <domain>\<login>qualifiziert werden, z. B LONDON\Joeb. . Die Anmeldung kann nicht bereits einem Benutzer in der Datenbank zugeordnet werden.

[ @name_in_db = ] Ausgabe von N'name_in_db'

Der Name für den neuen Datenbankbenutzer. @name_in_db ist ein OUTPUT Parameter des Typs sysname. Wenn nicht angegeben, wird @loginame verwendet. Wenn sie als Variable OUTPUT mit dem Wert von NULLangegeben ist, wird @name_in_db auf @loginame gesetzt. @name_in_db darf nicht bereits in der aktuellen Datenbank vorhanden sein.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Hinweise

sp_grantdbaccess Aufrufe CREATE USER, die zusätzliche Optionen unterstützen. Informationen zur Erstellung von Datenbankbenutzern finden CREATE USERSie unter . Um einen Datenbankbenutzer aus einer Datenbank zu entfernen, verwenden DROP USERSie .

sp_grantdbaccess kann nicht innerhalb einer benutzerdefinierten Transaktion ausgeführt werden.

Berechtigungen

Setzt die Mitgliedschaft in der festen Datenbankrolle db_owner oder in der festen Datenbankrolle db_accessadmin voraus.

Beispiele

Im folgenden Beispiel wird CREATE USER ein Datenbankbenutzer für das Windows-Konto Edmonds\LolanSo zur aktuellen Datenbank hinzugefügt, bei dem es sich um die bevorzugte Methode zum Erstellen eines Datenbankbenutzers handelt. Der neue Benutzer erhält den Namen Lolan.

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