sp_enableagentoffload (Transact-SQL)
@job_id パラメータで識別されるレプリケーション プッシュ エージェントの、リモート エージェントのアクティブ化を有効にします。このストアド プロシージャは、現在リモート エージェント サーバーであるコンピュータ上で実行されます。このストアド プロシージャは、パブリッシャ側でパブリケーション データベースについて実行されます。
.gif "ms186246.note(ja-jp,SQL.90).gif") 重要 : |
|---|
| Microsoft SQL Server 2005 以降を実行するディストリビュータに対するリモート エージェントのアクティブ化のサポートは中止されました。 |
.gif "トピック リンク アイコン")
構文
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 です。
解説
sp_enableagentoffload は、別のサーバーでディストリビューション エージェントまたはマージ エージェントの処理を実行できる機能を有効にするときに使用します。
sp_enableagentoffload が正常終了すると、レプリケーション エージェントのコマンド ラインに**–Offloadoffloadserver パラメータが付加されるか、–Offload**offloadserver パラメータが既にコマンド ラインに存在する場合には、新しい 'remote_agent_server_name' により更新されます。
また、MSdistribution_agents (Transact-SQL) 内のエージェントに対する offload_enabled フィールドが 1 に設定され、'remote_agent_server_name' に新しい値が指定されていれば、これにより offload-server フィールドが更新されます。
権限
sp_enableagentoffload を実行できるのは、固定サーバー ロール sysadmin または固定データベース ロール db_owner のメンバ、あるいは指定エージェントのサブスクリプションの所有者だけです。
戻り値
成功した場合は 0 を、失敗した場合は 1 をそれぞれ返します。
参照
関連項目
システム ストアド プロシージャ (Transact-SQL)