sysmail_help_principalprofile_sp (Transact-SQL)

Artikel
06/18/2013

Führt Informationen zu Zuordnungen zwischen Datenbank-E-Mail-Profilen und Datenbankprinzipalen auf.

Themenlink (Symbol) 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 der Datenbank oder Rolle in der msdb-Datenbank für die Zuordnung, die aufgelistet werden soll. principal_id ist vom Datentyp int. Der Standardwert ist NULL. Es kann entweder principal_id oder principal_name angegeben werden.
[ @principal_name= ] 'principal_name'
Der Name der Datenbank oder Rolle in der msdb-Datenbank für die Zuordnung, die aufgelistet werden soll. principal_name ist vom Datentyp sysname. Der Standardwert ist NULL. Es kann entweder principal_id oder principal_name angegeben werden.
[ @profile_id= ] profile_id
Die ID des Profils für die Zuordnung, die aufgelistet werden soll. profile_id ist vom Datentyp int. Der Standardwert ist NULL. Es kann entweder profile_id oder profile_name angegeben werden.
[ @profile_name= ] 'profile_name'
Der Name des Profils für die Zuordnung, die aufgelistet werden soll. profile_name ist vom Datentyp sysname. Der Standardwert ist NULL. Es kann entweder profile_id oder profile_name angegeben werden.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

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

Wird sysmail_help_principalprofile_sp ohne Parameter aufgerufen, werden im zurückgegebenen Resultset alle Zuordnungen in der Instanz von SQL Server aufgelistet. 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 wird in der msdb-Datenbank gespeichert und befindet sich im Besitz des dbo-Schemas. Die Prozedur muss mithilfe eines dreiteiligen Namens ausgeführt werden, wenn es sich bei der aktuellen Datenbank nicht um msdb handelt.

Berechtigungen

Erfordert die Mitgliedschaft in der festen Serverrolle sysadmin.

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.

EXECUTE 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.Auflisten von Informationen für alle Zuordnungen

Im folgenden Beispiel werden die Informationen für alle Zuordnungen in der Instanz aufgelistet.

EXECUTE 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

Freigeben über