sp_helpuser (Transact-SQL)

Artikel
12/15/2008

Aktualisiert: 14. April 2006

Stellt Informationen zu Prinzipalen auf Datenbankebene in der aktuellen Datenbank bereit.

Wichtig:
sp_helpuser gibt keine Informationen zu sicherungsfähigen Elementen zurück, die in SQL Server 2005 eingeführt wurden. Verwenden Sie stattdessen sys.database_principals.

Themenlink (Symbol) Transact-SQL-Syntaxkonventionen

Syntax

sp_helpuser [ [ @name_in_db = ] 'security_account' ]

Argumente

[ @name_in_db = ] 'security_account'
Der Name des Datenbankbenutzers oder der Datenbankrolle in der aktuellen Datenbank. security_account muss in der aktuellen Datenbank vorhanden sein. security_account ist vom Datentyp sysname und hat den Standardwert NULL. Falls security_account nicht angegeben ist, gibt sp_helpuser Informationen zu allen Datenbankprinzipalen zurück.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

Die folgende Tabelle zeigt, wie das Resultset aussieht, wenn weder ein Benutzerkonto noch ein SQL Server-Benutzer oder Windows-Benutzer für security_account angegeben ist.

Spaltenname	Datentyp	Beschreibung
UserName	sysname	Benutzer in der aktuellen Datenbank.
GroupName	sysname	Rollen, zu denen UserName gehört.
LoginName	sysname	Anmeldename von UserName.
DefDBName	sysname	Standarddatenbank von UserName.
DefSchemaName	sysname	Standardschema des Datenbankbenutzers.
UserID	smallint	ID von UserName in der aktuellen Datenbank.
SID	smallint	Sicherheits-ID (SID) des Benutzers.

Die folgende Tabelle zeigt, wie das Resultset aussieht, wenn kein Benutzerkonto angegeben ist und Aliase in der aktuellen Datenbank vorhanden sind.

Spaltenname	Datentyp	Beschreibung
LoginName	sysname	Anmeldenamen, die mithilfe eines Alias mit Benutzern in der aktuellen Datenbank verknüpft sind.
UserNameAliasedTo	sysname	Benutzername in der aktuellen Datenbank, mit dem der Anmeldename mithilfe eines Alias verknüpft ist.

Die folgende Tabelle zeigt, wie das Resultset aussieht, wenn eine Rolle für security_account angegeben ist.

Spaltenname	Datentyp	Beschreibung
Group_name	sysname	Name der Rolle in der aktuellen Datenbank.
Group_id	smallint	Rollen-ID für die Rolle in der aktuellen Datenbank.
Users_in_group	sysname	Mitglied der Rolle in der aktuellen Datenbank.
Userid	smallint	Benutzer-ID für das Rollenmitglied.

Hinweise

Verwenden Sie sys.database_role_members, um Informationen zur Mitgliedschaft in Datenbankrollen anzuzeigen. Verwenden Sie sys.server_role_members, um Informationen zur Mitgliedschaft in Serverrollen anzuzeigen, und verwenden Sie sys.server_principals, um Informationen zu Prinzipalen auf Serverebene anzuzeigen.

Das Ausführen von sp_helpuser für eine Datenbankrolle entspricht dem Ausführen von sp_helpgroup für diese Datenbankrolle.

Berechtigungen

Erfordert die Mitgliedschaft in der public-Rolle.

Die zurückgegebenen Informationen unterliegen den Einschränkungen, die für den Zugriff auf Metadaten gelten. Entitäten, für die der Prinzipal keine Berechtigungen besitzt, werden nicht angezeigt. Weitere Informationen finden Sie unter Konfigurieren der Sichtbarkeit von Metadaten.

Beispiele

A. Auflisten aller Benutzer

Im folgenden Beispiel werden alle Benutzer in der aktuellen Datenbank aufgelistet.

EXEC sp_helpuser

B. Auflisten von Informationen für einen einzelnen Benutzer

Im folgenden Beispiel werden Informationen zum Datenbankbesitzer (dbo) aufgelistet.

EXEC sp_helpuser 'dbo'

C. Auflisten von Informationen für eine Datenbankrolle

Im folgenden Beispiel werden Informationen zur festen Datenbankrolle db_securityadmin aufgelistet.

EXEC sp_helpuser 'db_securityadmin'

Siehe auch

Änderungsverlauf

Version	Verlauf
14. April 2006	Neuer Inhalt: Die DefSchemaName-Spalte wurde hinzugefügt.