Freigeben über

  • Artikel

sysmail_help_principalprofile_sp (Transact-SQL)

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
    Entspricht der ID des Datenbankbenutzers oder der Rolle in der msdb-Datenbank für die aufzuführende Zuordnung. principal_id ist vom Datentyp int und hat den Standardwert NULL. Es kann entweder principal_id oder principal_name angegeben werden.

  • [ @principal_name= ] 'principal_name'
    Entspricht dem Namen des Datenbankbenutzers oder der Rolle in der msdb-Datenbank für die aufzuführende Zuordnung. principal_name ist vom Datentyp sysname und hat den Standardwert NULL. Es kann entweder principal_id oder principal_name angegeben werden.

  • [ @profile_id= ] profile_id
    Die Profil-ID der 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 AdventureWorks2008R2 Administrator und dem Prinzipal ApplicationLogin in der msdb-Datenbank aufgelistet.

EXECUTE msdb.dbo.sysmail_help_principalprofile_sp
    @principal_name = 'danw',
    @profile_name = 'AdventureWorks2008R2 Administrator' ;

Es folgt ein Beispielresultset, das auf Zeilenlänge umformatiert wurde.

principal_id principal_name     profile_id  profile_name                   is_default
------------ ------------------ ----------- ------------------------------ ----------
5            danw               9           AdventureWorks2008R2 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           AdventureWorks2008R2 Administrator   1