Sdílet prostřednictvím

sysmail_add_profileaccount_sp (Transact-SQL)

platí pro:SQL Server

Přidá účet Databázové pošty do profilu Databázové pošty. Spusťte sysmail_add_profileaccount_sp se po vytvoření účtu databáze pomocí sysmail_add_account_sp a vytvoří se profil databáze s sysmail_add_profile_sp.

Transact-SQL konvence syntaxe

Syntaxe

sysmail_add_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 pro přidání účtu. @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 pro přidání účtu. @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 přidat do profilu. @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 přidat do profilu. @account_name je sysname, s výchozím nastavením NULL. Je nutné zadat @account_id nebo @account_name .

[ @sequence_number = ] sequence_number

Pořadové číslo účtu v rámci profilu. @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í).

Poznámky

Profil i účet už musí existovat. V opačném případě uložená procedura vrátí chybu.

Tato uložená procedura nezmění pořadové číslo účtu, který je již přidružený k zadanému profilu. Další informace o aktualizaci pořadového čísla účtu najdete v tématu sysmail_update_profileaccount_sp.

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ý má nejnižší pořadové číslo. Pokud se tento účet nezdaří, databázová pošta použije tento účet s dalším nejvyšším pořadovým číslem a tak dále, dokud databázová pošta zprávu úspěšně neodešle, nebo účet s nejvyšším pořadovým číslem selže. Pokud se účet s nejvyšším pořadovým číslem nezdaří, databáze pošta pozastaví pokusy o odeslání e-mailu po dobu nakonfigurovanou v AccountRetryDelay parametru sysmail_configure_sp, pak spustí proces opětovného pokusu o odeslání e-mailu, počínaje nejnižším pořadovým číslem. Pomocí parametru < a0/> nakonfigurujte počet pokusů externího e-mailového procesu odeslat e-mailovou zprávu pomocí každého účtu v zadaném profilu.

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_add_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 přidruží profil AdventureWorks Administrator k účtu Audit Account. Účet auditu má pořadové číslo 1.

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

Související obsah

  • Last updated on