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。
請參閱
參考
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)