Udostępnij za pomocą

sysmail_add_profileaccount_sp (Transact-SQL)

Dotyczy:SQL Server

Dodaje konto poczty bazy danych do profilu poczty bazy danych. Wykonaj sysmail_add_profileaccount_sp polecenie po utworzeniu konta bazy danych przy użyciu sysmail_add_account_sp, a profil bazy danych jest tworzony przy użyciu sysmail_add_profile_sp.

Transact-SQL konwencje składni

Składnia

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 (w programowaniu)

[ @profile_id = ] profile_id

Identyfikator profilu do dodania konta. @profile_id jest int z wartością domyślną NULL. Należy określić @profile_id lub @profile_name .

[ @profile_name = ] 'profile_name'

Nazwa profilu, do których chcesz dodać konto. @profile_name to nazwa systemu z wartością domyślną NULL. Należy określić @profile_id lub @profile_name .

[ @account_id = ] account_id

Identyfikator konta, który ma zostać dodany do profilu. @account_id jest int z wartością domyślną NULL. Należy określić @account_id lub @account_name .

[ @account_name = ] 'account_name'

Nazwa konta, które ma zostać dodane do profilu. @account_name to nazwa systemu z wartością domyślną NULL. Należy określić @account_id lub @account_name .

[ @sequence_number = ] sequence_number

Numer sekwencji konta w profilu. @sequence_numbernie ma wartości domyślnej. Numer sekwencji określa kolejność, w jakiej konta są używane w profilu.

Zwracanie wartości kodu

0 (powodzenie) lub 1 (niepowodzenie).

Uwagi

Zarówno profil, jak i konto muszą już istnieć. W przeciwnym razie procedura składowana zwraca błąd.

Ta procedura składowana nie zmienia numeru sekwencji konta skojarzonego już z określonym profilem. Aby uzyskać więcej informacji na temat aktualizowania numeru sekwencji konta, zobacz sysmail_update_profileaccount_sp.

Numer porządkowy określa kolejność, w jakiej Poczta Bazy Danych używa kont w profilu. W przypadku nowej wiadomości e-mail poczta bazy danych rozpoczyna się od konta, które ma najniższy numer sekwencji. Jeśli to konto zakończy się niepowodzeniem, usługa Database Mail używa konta z następnym najwyższym numerem sekwencji itd., dopóki poczta bazy danych nie wyśle wiadomości pomyślnie lub konto z najwyższym numerem sekwencji zakończy się niepowodzeniem. Jeśli konto o najwyższym numerze sekwencji zakończy się niepowodzeniem, poczta bazy danych wstrzymuje próbę wysłania wiadomości e-mail przez czas skonfigurowany w AccountRetryDelay parametrze sysmail_configure_sp, a następnie rozpoczyna proces ponownego wysyłania wiadomości e-mail, rozpoczynając od najniższego numeru sekwencji. AccountRetryAttempts Użyj parametru sysmail_configure_sp, aby skonfigurować liczbę prób wysłania wiadomości e-mail przez proces zewnętrznej poczty e-mail przy użyciu każdego konta w określonym profilu.

Jeśli istnieje więcej niż jedno konto z tym samym numerem sekwencji, poczta bazy danych używa tylko jednego z tych kont dla danej wiadomości e-mail. W takim przypadku poczta bazy danych nie gwarantuje, które konta są używane dla tego numeru sekwencji lub że to samo konto jest używane z wiadomości do wiadomości.

Procedura sysmail_add_profileaccount_sp składowana znajduje się w msdb bazie danych i jest własnością schematu dbo . Procedura musi być wykonywana z trzyczęściową nazwą, jeśli bieżąca baza danych nie msdbjest .

Uprawnienia

Możesz udzielić EXECUTE uprawnień do tej procedury, ale te uprawnienia mogą zostać zastąpione podczas uaktualniania programu SQL Server.

Przykłady

Poniższy przykład kojarzy profil AdventureWorks Administrator z kontem Audit Account. Konto inspekcji ma numer 1sekwencji .

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

Treści powiązane

  • Last updated on