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