Udostępnij za pośrednictwem

  • Artykuł

sysmail_add_profileaccount_sp (języka Transact-SQL)

Dodaje konto poczty bazy danych do profilu poczty bazy danych.wykonać sysmail_add_profileaccount_sp Po utworzeniu konta bazy danych z sysmail_add_account_sp (Transact-SQL), a profil bazy danych jest tworzone za pomocą sysmail_add_profile_sp (Transact-SQL).

Topic link iconKonwencje składni języka Transact-SQL

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
    The profile id to add the account to.profile_id is int, with a default of NULL.Albo profile_id lub profile_name musi być określona.

  • [ @ nazwa_profilu = ] "profile_name'
    The profile name to add the account to.profile_name is sysname, with a default of NULL.Albo profile_id lub profile_name musi być określona.

  • [ @ account_id = ] account_id
    The account id to add to the profile.account_id is int, with a default of NULL.Albo account_id lub account_name musi być określona.

  • [ @ nazwa_konta = ] "account_name'
    The name of the account to add to the profile.account_name is sysname, with a default of NULL.Albo account_id lub account_name musi być określona.

  • [ @ sequence_number = ] sequence_number
    The sequence number of the account within the profile.sequence_number is int, with no default.ZMIENIANIE SCHEMATU XML kolekcja

Wartości kodów powrotnych

0 (sukces) lub 1 (brak)

Remarks

Zarówno w profilu i konta musi już istnieć.W przeciwnym wypadku procedura przechowywana zwraca błąd.

Należy zauważyć, że tej procedura przechowywana nie zmienia się kolejny numer konta, które ma już skojarzony z określonym profilem.Aby uzyskać więcej informacji na temat aktualizowania kolejny numer konta Zobacz sysmail_update_profileaccount_sp (języka Transact-SQL).

Numer sekwencyjny określa kolejność, w jakiej funkcja poczty bazy danych używa kont dostępnych w profilu.W przypadku nowej wiadomości e-mail funkcja poczty bazy danych najpierw używa konta o najniższym numerze sekwencyjnym.Jeśli użycie tego konta nie powiedzie się, funkcja poczty bazy danych używa konta o następnym najwyższym numerze sekwencyjnym itd., dopóki wiadomość nie zostanie wysłana pomyślnie lub użycie konta o najwyższym numerze sekwencyjnym nie powiedzie się.Jeśli użycie konta o najwyższym numerze sekwencyjnym nie powiedzie się, funkcja poczty bazy danych wstrzymuje próby wysłania wiadomości na czas skonfigurowany w parametrze AccountRetryDelay funkcji sysmail_configure_sp, a następnie ponownie rozpoczyna proces podejmowania prób wysłania wiadomości, zaczynając od najniższego numeru sekwencyjnego.Aby skonfigurować liczbę prób wysłania wiadomości e-mail przez zewnętrzny proces poczty przy użyciu każdego konta w określonym profilu, należy użyć parametru AccountRetryAttempts funkcji sysmail_configure_sp.

Jeśli istnieje więcej niż jedno konto o tym samym numerze sekwencyjnym, funkcja poczty bazy danych używa tylko jednego w tych kont dla danej wiadomości e-mail.W takim przypadku funkcja poczty bazy danych nie daje gwarancji, którego konta użyje dla danego numeru sekwencyjnego ani że dla poszczególnych wiadomości będzie używane to samo konto.

Procedura przechowywana sysmail_add_profileaccount_sp is in the msdb bazy danych, a właścicielem dbo schematu.Procedura musi być wykonane o nazwie trzy części, jeśli bieżąca baza danych nie jest msdb.

Uprawnienia

Uprawnienia dla tej wartości domyślnej procedury do członków do wykonywania sysadmin ustalić roli serwera.

Przykłady

W poniższym przykładzie kojarzy profilu AdventureWorks Administrator z kontem Audit Account. Konto inspekcji ma numer sekwencyjny 1.

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