sysmail_help_principalprofile_sp (Transact-SQL)

  • Artikel

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

Diese gespeicherte Prozedur gehört der db_owner Rolle. Sie können berechtigungen für jeden Benutzer erteilen EXECUTE , diese Berechtigungen können jedoch 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

Zugehöriger Inhalt