Share via


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,沒有預設值。 如需系統設定檔中已定義的參數清單,請參閱<複寫代理程式設定檔>。 如需每個代理程式完整的有效參數清單,請參閱下列主題:

  • [ @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)

概念

處理複寫代理程式設定檔