• Artikel

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. Namen von Windows-Gruppen und Windows-Anmeldungen müssen mit einem Windows-Domänennamen im Format Domain\login gekennzeichnet werden, wie z. B. LONDON\Joeb. Der Anmeldename darf nicht bereits einem Benutzer in der Datenbank zugeordnet sein. login ist ein Wert vom Datentyp sysname und weist keinen Standardwert auf.

  • [ @name_in_db=] 'name_in_db' [ OUTPUT]
    Der Name des neuen Datenbankbenutzers. name_in_db ist eine OUTPUT-Variable vom Datentyp sysname; der Standardwert ist NULL. Wenn dieses Argument nicht angegeben ist, wird login verwendet. Wenn dieses Argument als OUTPUT-Variable mit dem Wert NULL angegeben wird, wird @name_in_db auf login festgelegt. name_in_db darf nicht bereits in der aktuellen Datenbank 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