sp_enableagentoffload (Transact-SQL)
啟用 @job_id 參數所識別之複寫發送代理程式的遠端代理程式啟動功能。這個預存程序執行於目前是遠端代理程式伺服器的電腦。這個預存程序執行於發行集資料庫的發行者端。
重要事項: |
---|
已卸除執行 Microsoft SQL Server 2005 和更新版本的散發者之遠端代理程式啟動支援。 |
語法
sp_enableagentoffload [ @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_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。