sysmail_update_profileaccount_sp (Transact-SQL)

Artikel
06/18/2013

Aktualisiert die Sequenznummer eines Kontos in einem Datenbank-E-Mail-Profil.

Themenlink (Symbol) Transact-SQL-Syntaxkonventionen

Syntax

sysmail_update_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 des Profils, das aktualisiert werden soll. 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 des Profils, das aktualisiert werden soll. 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 ID des Kontos, das aktualisiert werden soll. 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 zu aktualisierenden Kontos. 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 neue Sequenznummer für das Konto. sequence_number ist vom Datentyp int und hat keinen Standardwert. Über die Sequenznummer wird die Reihenfolge festgelegt, in der Konten im Profil verwendet werden.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

Keine

Hinweise

Gibt einen Fehler zurück, wenn das angegebene Konto nicht dem angegebenen Profil zugeordnet ist.

Über die Sequenznummer wird die Reihenfolge festgelegt, in der Konten im Profil von 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 einen Fehler erzeugt, verwendet Datenbank-E-Mail das Konto mit der nächsthöheren Sequenznummer usw., bis entweder Datenbank-E-Mail die Nachricht erfolgreich versendet oder das Konto mit der höchsten Sequenznummer einen Fehler erzeugt. Wenn das Konto mit der höchsten Sequenznummer einen Fehler erzeugt, dann wird die E-Mail-Nachricht nicht versandt.

Sind mehrere Konten mit der gleichen Sequenznummer vorhanden, verwendet Datenbank-E-Mail nur eines dieser Konten für eine bestimmte E-Mail-Nachricht. In diesem Fall kann 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_update_profileaccount_sp wird in der msdb-Datenbank gespeichert und befindet sich im Besitz des dbo-Schemas. Handelt es sich bei der aktuellen Datenbank nicht um msdb, muss die Prozedur mit einem dreiteiligen Namen ausgeführt werden.

Berechtigungen

Die Ausführungsberechtigungen erhalten standardmäßig Mitglieder der festen Serverrolle sysadmin.

Beispiele

Im folgenden Beispiel wird die Sequenznummer des Kontos Admin-BackupServer innerhalb des Profils AdventureWorks Administrator in der msdb-Datenbank geändert. Nach der Ausführung dieses Codes lautet die Sequenznummer für das Konto 3, was bedeutet, dass es verwendet wird, wenn die beiden ersten Konten einen Fehler erzeugen.

EXECUTE msdb.dbo.sysmail_update_profileaccount_sp
    @profile_name = 'AdventureWorks Administrator'
    ,@account_name = 'Admin-BackupServer',
    ,@sequence_number = 3;