sp_disableagentoffload (Transact-SQL)
停用 @job_id 參數所識別之複寫發送代理程式的遠端發送代理程式啟動功能。這個預存程序執行於發行集資料庫的發行者端。
.gif "ms187756.note(zh-tw,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 Agent 作業識別碼。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，如果提供了 'remote_agent_server_name' 所指定之新值，便以這個值來更新 offload-server 欄位。
權限
只有系統管理員 (sysadmin) 固定伺服器角色或 db_owner 固定資料庫角色的成員，或指定代理程式的訂閱擁有者，才能夠執行 sp_disableagentoffload。
請參閱
參考
sp_enableagentoffload (Transact-SQL)
系統預存程序 (Transact-SQL)