sp_add_agent_parameter (Transact-SQL)

將新的參數及其值加入代理程式設定檔中。這個預存程序執行於任何資料庫中的散發者端。

Transact-SQL 語法慣例

語法

sp_add_agent_parameter [ @profile_id = ] profile_id
        , [ @parameter_name = ] 'parameter_name' 
        , [ @parameter_value = ] 'parameter_value' 

引數

• [ @profile_id=] profile_id
  這是 msdb 資料庫之 MSagent_profiles 資料表的設定檔識別碼。profile_id 是 int，沒有預設值。

  若要知道這個 profile_id 所代表的代理程式類型，請在 MSagent_profiles (Transact-SQL) 資料表中找出 profile_id，記下 agent_type 欄位值。其值如下：

  值	描述
  1	快照集代理程式
  2	記錄讀取器代理程式
  3	散發代理程式
  4	合併代理程式
  9	佇列讀取器代理程式

• [ @parameter_name=] 'parameter_name'
  這是參數的名稱。parameter_name 是 sysname，沒有預設值。如需系統設定檔中已定義的參數清單，請參閱＜複寫代理程式設定檔＞。如需每個代理程式完整的有效參數清單，請參閱下列主題：

  • Replication Snapshot Agent
  • Replication Log Reader Agent
  • Replication Distribution Agent
  • Replication Merge Agent
  • Replication Queue Reader Agent

• [ @parameter_value=] 'parameter_value'
  這是要指派給參數的值。parameter_value 是 nvarchar(255)，沒有預設值。

傳回碼值

0 (成功) 或 1 (失敗)

備註

sp_add_agent_parameter 用於快照式複寫、交易式複寫和合併式複寫中。

權限

只有系統管理員 (sysadmin) 固定伺服器角色的成員，才能夠執行 sp_add_agent_parameter。

請參閱

參考

sp_add_agent_profile (Transact-SQL)
sp_change_agent_profile (Transact-SQL)
sp_change_agent_parameter (Transact-SQL)
sp_drop_agent_parameter (Transact-SQL)
sp_help_agent_parameter (Transact-SQL)

其他資源

How to: Work with Replication Agent Profiles (Replication Transact-SQL Programming)
複寫代理程式設定檔

說明及資訊

取得 SQL Server 2005 協助