sp_add_agent_parameter (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,沒有預設值。如需系統設定檔中已定義的參數清單,請參閱<複寫代理程式設定檔>。如需每個代理程式完整的有效參數清單,請參閱下列主題:[@parameter_value=] 'parameter_value'
這是要指派給參數的值。parameter_value 是 nvarchar(255),沒有預設值。
傳回碼值
0 (成功) 或 1 (失敗)
備註
sp_add_agent_parameter 用於快照式複寫、交易式複寫和合併式複寫中。
權限
只有系統管理員 (sysadmin) 固定伺服器角色的成員,才能夠執行 sp_add_agent_parameter。