sysmail_add_profileaccount_sp (Transact-SQL)

將 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_spmsdb 資料庫中,擁有者是 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 ;

請參閱

參考

Database Mail 預存程序 (Transact-SQL)

概念

Database Mail

建立 Database Mail 帳戶

Database Mail 組態物件