Transact-SQL 参考

sp_enableagentoffload

启用由 @job_id 参数标识的复制强制代理程序的远程代理程序激活。该存储过程在当前作为远程代理服务器的计算机上运行。该存储过程在发布服务器的发布数据库上执行。

语法

sp_enableagentoffload [ @job_id = ] job_id
    [ , [ @offloadserver = ] 'remote_agent_server_name' ]
    [ , [ @agent_type = ] 'agent_type' ]

参数

[@job_id = ] 'job_id'

指定从远程激活启用复制代理程序的 SQL Server 代理程序作业标识符。job_id 的数据类型为 varbinary(16),没有默认设置。

[@offloadserver = ] 'remote_agent_server_name'

指定用于远程代理程序激活的服务器的网络名称。remote_agent_server_name 的数据类型为 sysname,默认设置为 NULL。如果是 NULL,则使用 MSDistribution_agents 表中的当前 offload_server。

[@agent_type = ] 'agent_type'

是代理程序类型。agent_type 的数据类型为 sysname,默认设置为 NULL,用以指定系统将确定代理程序类型是 distribution 还是 merge。有效值为 distributionmerge 或 NULL。

返回代码值

0(成功)或 1(失败)

注释

sp_enableagentoffload 用于在其它服务器上启用分发代理程序或合并代理程序。

成功完成 sp_enableagentoffload 后,–Offload offloadserver 参数将被立即附加到复制代理程序命令行,或者如果 –Offload offloadserver 参数已经存在于命令行,则用新的 remote_agent_server_name 更新 –Offload offloadserver 参数。

同样,MSDistribution_agents 中用于代理程序的 offload_enabled 字段将设置为 1,并将用 'remote_agent_server_name' 中指定的新值(如果有)更新 offload-server 字段。

权限

只有 sysadmin 固定服务器角色成员、db_owner 固定数据库角色成员或指定代理程序的订阅所有者才能执行 sp_enableagentoffload

请参见

DTS 包详细信息

远程代理程序激活

系统存储过程