sysmail_add_profileaccount_sp (Transact-SQL)

Artikel
06/18/2013

Fügt einem Profil für die Datenbank-E-Mail ein Konto für die Datenbank-E-Mail hinzu. Führen Sie sysmail_add_profileaccount_sp aus, nachdem ein Datenbankkonto mithilfe von sysmail_add_account_sp (Transact-SQL) und ein Datenbankprofil mithilfe von sysmail_add_profile_sp (Transact-SQL) erstellt wurde.

Themenlink (Symbol) Transact-SQL-Syntaxkonventionen

Syntax

sysmail_add_profileaccount_sp { [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' } ,
    { [ @account_id = ] account_id | [ @account_name = ] 'account_name' }
    [ , [ @sequence_number = ] sequence_number ]

Argumente

[ @profile_id = ] profile_id
Die Profil-ID, der das Konto hinzugefügt wird. profile_id ist vom Datentyp int. Der Standardwert ist NULL. Es muss entweder profile_id oder profile_name angegeben werden.
[ @profile_name = ] 'profile_name'
Der Profilname, dem das Konto hinzugefügt wird. profile_name ist vom Datentyp sysname. Der Standardwert ist NULL. Es muss entweder profile_id oder profile_name angegeben werden.
[ @account_id = ] account_id
Die Konto-ID, die dem Profil hinzugefügt wird. account_id ist vom Datentyp int. Der Standardwert ist NULL. Es muss entweder account_id oder account_name angegeben werden.
[ @account_name = ] 'account_name'
Der Name des Kontos, das dem Profil hinzugefügt wird. account_name ist vom Datentyp sysname. Der Standardwert ist NULL. Es muss entweder account_id oder account_name angegeben werden.
[ @sequence_number = ] sequence_number
Die Sequenznummer des Kontos innerhalb des Profils. sequence_number ist vom Datentyp int und hat keinen Standardwert. Mithilfe der Sequenznummer wird die Reihenfolge festgelegt, in der Konten im Profil verwendet werden.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

Sowohl das Profil als auch das Konto müssen bereits vorhanden sein. Andernfalls gibt die gespeicherte Prozedur einen Fehler zurück.

Beachten Sie, dass diese gespeicherte Prozedur nicht die Sequenznummer eines Kontos ändert, das bereits dem angegebenen Profil zugeordnet ist. Weitere Informationen zum Aktualisieren der Sequenznummer eines Kontos finden Sie unter sysmail_update_profileaccount_sp (Transact-SQL).

Über die Sequenznummer wird die Reihenfolge festgelegt, in der Konten im Profil der Datenbank-E-Mail verwendet werden. Für eine neue E-Mail-Nachricht beginnt Datenbank-E-Mail mit dem Konto mit der niedrigsten Sequenznummer. Wenn dieses Konto fehlschlägt, verwendet die Datenbank-E-Mail das Konto mit der nächsthöheren Sequenznummer usw., bis entweder die Datenbank-E-Mail die Nachricht erfolgreich versendet oder das Konto mit der höchsten Sequenznummer fehlschlägt. Wenn das Konto mit der höchsten Sequenznummer einen Fehler erzeugt, unterbricht die Datenbank-E-Mail die Versuche zum Senden der E-Mail für den Zeitraum, der im AccountRetryDelay-Parameter von sysmail_configure_sp konfiguriert ist. Danach wird das Senden der E-Mail erneut gestartet, wobei mit der niedrigsten Sequenznummer begonnen wird. Verwenden Sie den AccountRetryAttempts-Parameter von sysmail_configure_sp, um zu konfigurieren, wie oft der externe Mailprozess versuchen soll, die E-Mail-Nachricht mithilfe der einzelnen Konten im angegebenen Profil zu senden.

Sind mehrere Konten mit der gleichen Sequenznummer vorhanden, verwendet die Datenbank-E-Mail nur eines dieser Konten für eine bestimmte E-Mail-Nachricht. In diesem Fall kann die Datenbank-E-Mail nicht sicherstellen, welches der Konten für diese Sequenznummer verwendet wird oder dass für die einzelnen Nachrichten jeweils dasselbe Konto verwendet wird.

Die gespeicherte Prozedur sysmail_add_profileaccount_sp befindet sich in der msdb-Datenbank mit dem dbo-Schema als Besitzer. Handelt es sich bei der aktuellen Datenbank nicht um msdb, muss die Prozedur mit einem dreiteiligen Namen ausgeführt werden.

Berechtigungen

Standardmäßig verfügen Mitglieder der festen Serverrolle sysadmin über die Ausführungsberechtigungen.

Beispiele

Im folgenden Beispiel wird das Profil AdventureWorks Administrator dem Konto Audit Account zugeordnet. Das Konto für die Überwachung weist die Sequenznummer 1 auf.

EXECUTE msdb.dbo.sysmail_add_profileaccount_sp
    @profile_name = 'AdventureWorks Administrator',
    @account_name = 'Audit Account',
    @sequence_number = 1 ;