sysmail_add_profileaccount_sp (Transact-SQL)

發行項
06/18/2013

將 Database Mail 帳戶加入 Database Mail 設定檔中。請在利用 sysmail_add_account_sp (Transact-SQL) 來建立資料庫帳戶並利用 sysmail_add_profile_sp (Transact-SQL) 來建立資料庫設定檔之後，執行 sysmail_add_profileaccount_sp。

主題連結圖示 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 ]

引數

[ @profile_id = ] profile_id
這是要加入帳戶的設定檔識別碼。 profile_id 是 int，預設值是 NULL。您必須指定 profile_id 或 profile_name 其中之一。
[ @profile_name = ] 'profile_name'
這是要加入帳戶的設定檔名稱。 profile_name 是 sysname，預設值是 NULL。您必須指定 profile_id 或 profile_name 其中之一。
[ @account_id = ] account_id
這是要加入至設定檔的帳戶識別碼。 account_id 是 int，預設值是 NULL。您必須指定 account_id 或 account_name 其中之一。
[ @account_name = ] 'account_name'
這是要加入至設定檔的帳戶名稱。 account_name 是 sysname，預設值是 NULL。您必須指定 account_id 或 account_name 其中之一。
[ @sequence_number = ] sequence_number
帳戶在設定檔內的序號。 sequence_number 是 int，沒有預設值。序號決定了帳戶在設定檔中的使用順序。

傳回碼值

0 (成功) 或 1 (失敗)

備註

設定檔和帳戶都必須存在。否則，預存程序會傳回錯誤。

請注意，這個預存程序並不會變更已關聯於指定設定檔的帳戶序號。如需有關如何更新帳戶序號的詳細資訊，請參閱＜sysmail_update_profileaccount_sp (Transact-SQL)＞。

序號決定了 Database Mail 使用設定檔中之帳戶的順序。如果是新的電子郵件訊息，Database Mail 會從序號最低的帳戶開始。如果這個帳戶失敗，Database Mail 會使用序號次高的帳戶，依此類推，直到 Database Mail 傳送訊息成功為止，或直到序號最高的帳戶失敗為止。如果序號最高的帳戶失敗，Database Mail 會在 sysmail_configure_sp 的 AccountRetryDelay 參數所設定的時間之內，暫停傳送郵件，之後，再從最低的序號開始，重新嘗試傳送郵件的處理序。請利用 sysmail_configure_sp 的 AccountRetryAttempts 參數，設定外部郵件處理序嘗試利用指定設定檔中的每個帳戶，來傳送電子郵件訊息的次數。

如果有多個序號相同的帳戶存在，Database Mail 只會將其中一個帳戶用在給定的電子郵件訊息上。在這個情況下，Database Mail 並無法保證這個序號會用到哪個帳戶，也無法保證各訊息會用到相同的帳戶。

預存程序 sysmail_add_profileaccount_sp 在 msdb 資料庫中，擁有者是 dbo 結構描述。如果目前的資料庫不是 msdb，就必須利用三部分名稱來執行這個程序。

權限

這個程序的執行權限預設會授與系統管理員 (sysadmin) 固定伺服器角色的成員。

範例

下列範例會將 AdventureWorks Administrator 設定檔關聯於 Audit Account 帳戶。稽核帳戶的序號是 1。

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