共用方式為


sp_add_agent_parameter (Transact-SQL)

適用於:SQL Server Azure SQL 受控執行個體

將新的參數及其值新增至代理程式配置檔。 此預存程式會在任何資料庫的散發者端執行。

Transact-SQL 語法慣例

語法

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

引數

[ @profile_id = ] profile_id

資料庫中 MSagent_profiles 數據表中設定檔的 msdb 識別碼。 @profile_id為 int,沒有預設值。

若要瞭解此@profile_id所代表的代理程式類型,請在MSagent_profiles數據表中尋找@profile_id,並記下agent_type域值。 其值如下:

Description
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 用於快照式複寫、事務複製和合併式複寫。

權限

只有系統管理員固定伺服器角色的成員才能執行 sp_add_agent_parameter