Freigeben über


sp_grantdbaccess (Transact-SQL)

Fügt der aktuellen Datenbank einen Datenbankbenutzer hinzu.

Wichtiger HinweisWichtig

Diese Funktion wird in zukünftigen Versionen von Microsoft SQL Server nicht mehr bereitgestellt. Verwenden Sie diese Funktion beim Entwickeln neuer Anwendungen nicht, und planen Sie das Ändern von Anwendungen, in denen es zurzeit verwendet wird. Verwenden Sie stattdessen CREATE USER.

Themenlink (Symbol) Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

  • [ @loginame = ] **'**login '
    Der Name der Windows-Gruppe, Windows-Anmeldung oder SQL Server-Anmeldung, die dem neuen Datenbankbenutzer zugeordnet ist. Die Namen von Windows-Gruppen und Window-Anmeldenamen müssen mit einem Windows-Domänenname im Format Domain\login qualifiziert werden, z. B. LONDON\Joeb. Der Anmeldename darf noch keinem Benutzer in der Datenbank zugewiesen sein. login ist vom Datentyp sysname und hat keinen Standardwert.

  • [ @name_in_db=] 'name_in_db' [ OUTPUT]
    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 login festgelegt. name_in_db darf in der aktuellen Datenbank noch nicht vorhanden sein.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

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). 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

Siehe auch

Verweis

Gespeicherte Sicherheitsprozeduren (Transact-SQL)

CREATE USER (Transact-SQL)

DROP USER (Transact-SQL)

Gespeicherte Systemprozeduren (Transact-SQL)