Sdílet prostřednictvím

sysmail_update_profileaccount_sp (Transact-SQL)

platí pro:SQL Server

Aktualizuje pořadové číslo účtu v profilu databázové pošty.

Transact-SQL konvence syntaxe

Syntaxe

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

Argumenty

[ @profile_id = ] profile_id

ID profilu, který chcete aktualizovat. @profile_id je int, s výchozím nastavením NULL. Je nutné zadat @profile_id nebo @profile_name .

[ @profile_name = ] 'profile_name'

Název profilu, který chcete aktualizovat. @profile_name je sysname s výchozím nastavením NULL. Je nutné zadat @profile_id nebo @profile_name .

[ @account_id = ] account_id

ID účtu, které chcete aktualizovat. @account_id je int s výchozím nastavením NULL. Je nutné zadat @account_id nebo @account_name .

[ @account_name = ] 'account_name'

Název účtu, který chcete aktualizovat. @account_name je sysname, s výchozím nastavením NULL. Je nutné zadat @account_id nebo @account_name .

[ @sequence_number = ] sequence_number

Nové pořadové číslo pro účet. @sequence_number je int, bez výchozího nastavení. Pořadové číslo určuje pořadí, ve kterém se účty používají v profilu.

Hodnoty návratového kódu

0 (úspěch) nebo 1 (selhání).

Sada výsledků

Žádné.

Poznámky

Vrátí chybu, pokud zadaný účet není přidružený k zadanému profilu.

Pořadové číslo určuje pořadí, ve kterém databázová pošta používá účty v profilu. U nové e-mailové zprávy začíná databázová pošta účtem, který je nejnižší pořadové číslo. Pokud se tento účet nezdaří, použije databázová pošta účet s dalším nejvyšším pořadovým číslem atd., dokud databázová pošta zprávu úspěšně neodešle, nebo účet s nejvyšším pořadovým číslem selže. Pokud účet s nejvyšším pořadovým číslem selže, e-mailová zpráva selže.

Pokud existuje více účtů se stejným pořadovým číslem, použije databázová pošta pro danou e-mailovou zprávu pouze jeden z těchto účtů. V tomto případě databázová pošta neposkytuje žádné záruky, které z účtů se používají pro toto pořadové číslo nebo že stejný účet se používá ze zprávy do zprávy.

Uložená procedura sysmail_update_profileaccount_sp je v msdb databázi a vlastní schéma dbo . Pokud aktuální databáze není msdb, je nutné provést postup se třemi částmi.

Povolení

K tomuto postupu můžete udělit oprávnění EXECUTE, ale tato oprávnění se můžou při upgradu SQL Serveru přepsat.

Příklady

Následující příklad změní pořadové číslo účtu Admin-BackupServer v profilu AdventureWorks Administrator v msdb databázi. Po spuštění tohoto kódu je 3pořadové číslo účtu , což znamená, že se pokusí, pokud první dva účty selžou.

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

Související obsah

  • Last updated on