共用方式為


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_idint,預設值是 NULL。您必須指定 profile_idprofile_name 其中之一。
  • [ @profile_name = ] 'profile_name'
    帳戶要加入其中的設定檔名稱。profile_namesysname,預設值是 NULL。您必須指定 profile_idprofile_name 其中之一。
  • [ @account_id = ] account_id
    要加入設定檔的帳戶識別碼。account_idint,預設值是 NULL。您必須指定 account_idaccount_name 其中之一。
  • [ @account_name = ] 'account_name'
    要加入設定檔的帳戶名稱。account_namesysname,預設值是 NULL。您必須指定 account_idaccount_name 其中之一。
  • [ @sequence_number = ] sequence_number
    帳戶在設定檔內的序號。sequence_numberint,沒有預設值。序號決定了帳戶在設定檔中的使用順序。

傳回碼值

0 (成功) 或 1 (失敗)

備註

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

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

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

如果有多個序號相同的帳戶存在,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 和 SQL Mail 預存程序 (Transact-SQL)

其他資源

Database Mail
Database Mail 帳戶
Database Mail 設定檔
選取組態工作 (Database Mail)

說明及資訊

取得 SQL Server 2005 協助