sp_grantdbaccess (Transact-SQL)

  • Artikel

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 = ] 'login'  
    [ , [ @name_in_db = ] 'name_in_db' [ OUTPUT ] ]

Argumente

[ @loginame = ] 'login_ ' Ist der Name der Windows-Gruppe, der Windows-Anmeldung oder der SQL Server-Anmeldung, die dem neuen Datenbankbenutzer zugeordnet werden soll. Namen von Windows-Gruppen und Windows-Anmeldungen müssen mit einem Windows-Domänennamen im Format Domain\logingekennzeichnet werden, wie z. B. LONDON\Joeb. Der Anmeldename darf noch keinem Benutzer in der Datenbank zugewiesen sein. login ist vom Datentyp sysnameund hat keinen Standardwert.

[ @name_in_db = ] 'name_in_db' [ OUTPUT] Ist der Name für den neuen Datenbankbenutzer. name_in_db ist eine OUTPUT-Variable vom Datentyp sysname. Der Standardwert ist NULL. Wenn dieses Argument nicht angegeben ist, wird login verwendet. Bei Angabe als OUTPUT-Variable mit dem Wert NULL wird @name_in_db auf loginfestgelegt. name_in_db darf in der aktuellen Datenbank noch nicht vorhanden sein.

Rückgabecodewerte

„0“ (erfolgreich) oder „1“ (fehlerhaft)

Hinweise

sp_grantdbaccess ruft CREATE USER auf, wodurch zusätzliche Optionen unterstützt werden. Informationen zum Erstellen von Datenbankbenutzern finden Sie unter CREATE USER (Transact-SQL).For information about creating database users, see CREATE USER (Transact-SQL). 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 der aktuellen Datenbank mithilfe von CREATE USER ein Datenbankbenutzer für den Windows-Anmeldenamen Edmonds\LolanSo hinzugefügt. Der neue Benutzer erhält den Namen Lolan. Dies ist die bevorzugte Methode zum Erstellen eines Datenbankbenutzers.

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

Weitere Informationen

Gespeicherte Sicherheitsprozeduren (Transact-SQL)
CREATE USER (Transact-SQL)
DROP USER (Transact-SQL)
Gespeicherte Systemprozeduren (Transact-SQL)