将新参数及其值添加到代理程序配置中。此存储过程在运行代理程序的分发服务器的任何数据库上执行。

语法

sp_add_agent_parameter [ @profile_id = ] profile_id

    , [ @parameter_name = ] 'parameter_name'

    , [ @parameter_value = ] 'parameter_value'

参数

[@profile_id = ] profile_id

是 msdb 数据库内 MSagent_profiles 表中的配置 ID。profile_id 的数据类型为 int，没有默认设置。

[@parameter_name = ] 'parameter_name'

是参数名。parameter_name 的数据类型为 sysname，没有默认设置。对于系统配置文件，可更改的参数取决于代理程序的类型。若要找出 profile_id 所表示的代理程序类型，请在 Msagent_profiles 表中查找 profile_id，并注意 agent_type 字段的值。对于快照代理程序（它的 agent_type 字段值为 1），下列属性可以更改：

• bcpbatchsize
  
  



• historyverboselevel
  
  



• logintimeout
  
  



• maxbcpthreads
  
  



• querytimeout
  

  对于日志读取器代理程序（它的 agent_type 字段值为 2），下列属性可以更改：
  




• historyverboselevel
  
  



• logintimeout
  
  



• pollinginterval
  
  



• querytimeout
  
  



• readbatchsize
  
  



• readbatchthreshold
  

  对于分发代理程序（它的 agent_type 字段值为 3），下列属性可以更改：
  




• bcpbatchsize
  
  



• commitbatchsize
  
  



• commitbatchthreshold
  
  



• historyverboselevel
  
  



• logintimeout
  
  



• maxbcpthreads
  
  



• maxdeliveredtransactions
  
  



• pollinginterval
  
  



• querytimeout
  
  



• transactionsperhistory
  
  



• skiperrors
  

  对于合并代理程序（它的 agent_type 字段值为 4），下列属性可以更改：
  




• pollinginterval
  
  



• validateinterval
  
  



• logintimeout
  
  



• querytimeout
  
  



• maxuploadchanges
  
  



• maxdownloadchanges
  
  



• uploadgenerationsperbatch
  
  



• downloadgenerationsperbatch
  
  



• uploadreadchangesperbatch
  
  



• downloadreadchangesperbatch
  
  



• uploadwritechangesperbatch
  
  



• downloadwritechangesperbatch
  
  



• validate
  
  



• fastrowcount
  
  



• historyverboselevel
  
  



• changesperhistory
  
  



• bcpbatchsize
  
  



• numdeadlockretries
  

  对于自定义配置文件，可更改的参数取决于已定义的参数。若要查看已定义的参数，请运行 sp_help_agent_profile 查看与 profile_id 相关联的 profile_name。然后对于适当的 profile_id，运行 sp_help_agent_parameters 以查看与配置文件相关联的参数。
  

[@parameter_value = ] 'parameter_value'

是赋给参数的值。parameter_value 的数据类型为 nvarchar(255)，没有默认设置。

返回代码值

0（成功）或 1（失败）

注释

sp_add_agent_parameter 用于快照复制、事务复制和合并复制。

权限

只有 sysadmin 固定服务器角色成员才能执行 sp_add_agent_parameter。