Share via

sp_enableagentoffload (Transact-SQL)

  • 项目

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

ms186246.note(zh-cn,SQL.90).gif重要提示：
对于运行 Microsoft SQL Server 2005 和更高版本的分发服务器，已删除了远程代理激活功能。

主题链接图标Transact-SQL 语法约定

语法

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，或者为 NULL。

返回代码值

0（成功）或 1（失败）

备注

sp_enableagentoffload 用于启用对其他服务器运行分发代理或合并代理。

成功完成 sp_enableagentoffload 后，如果命令行中已存在 –Offloadoffloadserver 参数，则 –Offloadoffloadserver 参数将被追加到复制代理命令行中，或者使用新的 'remote_agent_server_name' 进行更新。

此外，MSdistribution_agents (Transact-SQL) 中用于代理的 offload_enabled 字段将被设置为 1，并且将用 'remote_agent_server_name' 中指定的新值（如果有）更新 offload-server 字段。

权限

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

请参阅

参考

系统存储过程 (Transact-SQL)

帮助和信息

获取 SQL Server 2005 帮助