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

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 vom Typ "sysname". Wenn nicht angegeben, wird @loginame verwendet. Wenn sie als AUSGABEvariable mit einem Wert von NULL, @name_in_db auf @loginame festgelegt ist. @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 zum Erstellen von Datenbankbenutzern finden Sie unter CREATE USER. Wenn Sie einen Datenbankbenutzer aus einer Datenbank entfernen möchten, verwenden Sie hierzu DROP USER.

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