sp_disableagentoffload (Transact-SQL)
禁用由 @job_id 参数标识的复制推送代理的远程推送代理激活。此存储过程在发布服务器上对发布数据库执行。
.gif "ms187756.note(zh-cn,SQL.90).gif") 重要提示： |
|---|
| 对于运行 Microsoft SQL Server 2005 和更高版本的分发服务器，删除了激活远程代理的功能。 |
语法
sp_disableagentoffload [ @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_disableagentoffload 用于删除在另一台服务器上运行分发代理或合并代理处理的能力。
成功完成 sp_disableagentoffload 后，–Offloadoffloadserver 参数便会立即从复制代理命令行删除。同样，MSdistribution_agents (Transact-SQL) 中用于代理的 offload_enabled 字段将设置为 0，并且 offload-server 字段使用 'remote_agent_server_name' 中指定的新值（如果提供）进行更新。
权限
只有 sysadmin 固定服务器角色的成员或 db_owner 固定数据库角色的成员，或指定代理的订阅所有者才能执行 sp_disableagentoffload。
请参阅
参考
sp_enableagentoffload (Transact-SQL)
系统存储过程 (Transact-SQL)