sysmail_help_profileaccount_sp (Transact-SQL)
Gilt für: SQL Server
Listet die Konten auf, die einem oder mehreren Datenbank-E-Mail-Profilen zugeordnet sind.
Transact-SQL-Syntaxkonventionen
Syntax
sysmail_help_profileaccount_sp
{ [ @profile_id = ] profile_id
| [ @profile_name = ] 'profile_name' }
[ , { [ @account_id = ] account_id
| [ @account_name = ] 'account_name' } ]
[ ; ]
Argumente
[ @profile_id = ] profile_id
Die Profil-ID des zu listenden Profils. @profile_id ist int, mit einem Standardwert von NULL
. Entweder @profile_id oder @profile_name müssen angegeben werden.
[ @profile_name = ] 'profile_name'
Der Profilname des zu listenden Profils. @profile_name ist "sysname" mit der Standardeinstellung "NULL
. Entweder @profile_id oder @profile_name müssen angegeben werden.
[ @account_id = ] account_id
Die zu listende Konto-ID. @account_id ist int, mit einem Standardwert von NULL
. Wenn @account_id und @account_name null sind, werden alle Konten im Profil aufgelistet.
[ @account_name = ] 'account_name'
Der Name des zu listenden Kontos. @account_name ist "sysname" mit der Standardeinstellung "NULL
. Wenn @account_id und @account_name null sind, werden alle Konten im Profil aufgelistet.
Rückgabecodewerte
0
(erfolgreich) oder 1
Fehler.
Resultset
Gibt ein Resultset mit den folgenden Spalten zurück.
Spaltenname | Datentyp | BESCHREIBUNG |
---|---|---|
profile_id |
int | Die Profil-ID des Profils. |
profile_name |
sysname | Der Name des Profils. |
account_id |
int | Die Konto-ID des Kontos. |
account_name |
sysname | Der Kontoname. |
sequence_number |
int | Die Sequenznummer des Kontos innerhalb des Profils. |
Hinweise
Wenn keine @profile_id oder @profile_name angegeben wird, gibt diese gespeicherte Prozedur Informationen für jedes Profil in der Instanz zurück.
Die gespeicherte Prozedur sysmail_help_profileaccount_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 msdb
vorhanden 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 der Konten für ein bestimmtes Profil anhand des Namens
Im folgenden Beispiel werden die Informationen für das AdventureWorks Administrator
-Profil durch Angeben des Profilnamens aufgelistet.
EXEC msdb.dbo.sysmail_help_profileaccount_sp
@profile_name = 'AdventureWorks Administrator';
Es folgt ein Beispielresultset, das auf Zeilenlänge umformatiert wurde:
profile_id profile_name account_id account_name sequence_number
----------- ---------------------------- ----------- -------------------- ---------------
131 AdventureWorks Administrator 197 Admin-MainServer 1
131 AdventureWorks Administrator 198 Admin-BackupServer 2
B. Auflisten der Konten für ein bestimmtes Profil nach Profil-ID
Im folgenden Beispiel werden die Informationen für das AdventureWorks Administrator
-Profil durch Angeben der Profil-ID für das Profil aufgelistet.
EXEC msdb.dbo.sysmail_help_profileaccount_sp
@profile_id = 131 ;
Es folgt ein Beispielresultset, das auf Zeilenlänge umformatiert wurde:
profile_id profile_name account_id account_name sequence_number
----------- ---------------------------- ----------- -------------------- ---------------
131 AdventureWorks Administrator 197 Admin-MainServer 1
131 AdventureWorks Administrator 198 Admin-BackupServer 2
C. Auflisten der Konten für alle Profile
Im folgenden Beispiel werden die Informationen für alle Profile in der Instanz aufgelistet.
EXEC msdb.dbo.sysmail_help_profileaccount_sp;
Es folgt ein Beispielresultset, das auf Zeilenlänge umformatiert wurde:
profile_id profile_name account_id account_name sequence_number
----------- ---------------------------- ----------- -------------------- ---------------
131 AdventureWorks Administrator 197 Admin-MainServer 1
131 AdventureWorks Administrator 198 Admin-BackupServer 2
106 AdventureWorks Operator 210 Operator-MainServer 1