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