sysmail_help_principalprofile_sp (Transact-SQL)
Gilt für: 
SQL Server
Führt Informationen zu Zuordnungen zwischen Datenbank-E-Mail-Profilen und Datenbankprinzipalen auf.
Transact-SQL-Syntaxkonventionen
Syntax
sysmail_help_principalprofile_sp [ { [ @principal_id = ] principal_id | [ @principal_name = ] 'principal_name' } ]
[ [ , ] { [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' } ]
[ ; ]
Argumente
[ @principal_id = ] principal_id
Die ID des Datenbankbenutzers oder der Datenbankrolle für msdb die Zuordnung zur Liste. @principal_id ist int mit einem Standardwert von NULL. Entweder @principal_id oder @principal_name müssen angegeben werden.
[ @principal_name = ] 'principal_name'
Der Name des Datenbankbenutzers oder der Datenbankrolle für msdb die Zuordnung zur Liste. @principal_name ist "sysname" mit der Standardeinstellung "NULL. Entweder @principal_id oder @principal_name müssen angegeben werden.
[ @profile_id = ] profile_id
Die ID des Profils für die Zuordnung zur Liste. @profile_id ist int, mit einem Standardwert von NULL. Entweder @profile_id oder @profile_name können angegeben werden.
[ @profile_name = ] 'profile_name'
Der Name des Profils für die Zuordnung zur Liste. @profile_name ist "sysname" mit der Standardeinstellung "NULL. Entweder @profile_id oder @profile_name können angegeben werden.
Rückgabecodewerte
0 (erfolgreich) oder 1 Fehler.
Resultset
Gibt ein Resultset zurück, das die in der folgenden Tabelle aufgelisteten Spalten enthält.
| Spaltenname | Datentyp | BESCHREIBUNG |
|---|---|---|
principal_id |
int | Die ID des Datenbankbenutzers. |
principal_name |
sysname | Der Name des Datenbankbenutzers. |
profile_id |
int | Die ID des Datenbank-E-Mail-Profils. |
profile_name |
sysname | Der Name des Datenbank-E-Mail-Profils. |
is_default |
bit | Das Flag, das besagt, ob es sich bei dem Profil um das Standardprofil des Benutzers handelt. |
Hinweise
Wenn sysmail_help_principalprofile_sp ohne Parameter aufgerufen wird, listet das zurückgegebene Resultset alle Zuordnungen in der SQL Server-Instanz auf. Andernfalls enthält das Resultset Informationen zu Zuordnungen, die mit den bereitgestellten Parametern übereinstimmen. So listet beispielsweise die Prozedur alle Zuordnungen für ein Profil auf, wenn der Profilname bereitgestellt wird.
sysmail_help_principalprofile_sp befindet sich in der msdb Datenbank und befindet sich im Besitz des dbo-Schemas . Die Prozedur muss mit einem dreiteiligen Namen ausgeführt werden, wenn die aktuelle Datenbank nicht msdbvorhanden ist.
Berechtigungen
Sie können Berechtigungen für dieses Verfahren erteilen EXECUTE , aber diese Berechtigungen können während eines SQL Server-Upgrades außer Kraft gesetzt werden.
Beispiele
A. Auflisten von Informationen für eine bestimmte Zuordnung
Im folgenden Beispiel werden die Informationen für alle Zuordnungen zwischen dem Profil AdventureWorks Administrator und dem Prinzipal ApplicationLogin in der msdb-Datenbank aufgelistet.
EXEC msdb.dbo.sysmail_help_principalprofile_sp
@principal_name = 'danw',
@profile_name = 'AdventureWorks Administrator';
Es folgt ein Beispielresultset, das auf Zeilenlänge umformatiert wurde.
principal_id principal_name profile_id profile_name is_default
------------ ------------------ ----------- ------------------------------ ----------
5 danw 9 AdventureWorks Administrator 1
B. Listeninformationen für alle Zuordnungen
Im folgenden Beispiel werden die Informationen für alle Zuordnungen in der Instanz aufgelistet.
EXEC msdb.dbo.sysmail_help_principalprofile_sp;
Es folgt ein Beispielresultset, das auf Zeilenlänge umformatiert wurde.
principal_id principal_name profile_id profile_name is_default
------------ ------------------ ----------- ------------------------------ ----------
6 terrid 3 Product Update Profile 1
5 danw 9 AdventureWorks Administrator 1