sp_post_msx_operation (Transact-SQL)
適用対象: SQL サーバー
ターゲット サーバーがダウンロードして実行できるように、 sysdownloadlist システム テーブルに操作 (行) を挿入します。
構文
sp_post_msx_operation
[ @operation = ] 'operation'
[ , [ @object_type = ] 'object' ]
{ , [ @job_id = ] job_id }
[ , [ @specific_target_server = ] 'target_server' ]
[ , [ @value = ] value ]
[ , [ @schedule_uid = ] schedule_uid ]
引数
[ @operation = ] 'operation'
転記された操作の操作の種類。 operation は varchar(64) で、既定値はありません。 有効な操作は、 object_typeによって異なります。
オブジェクトの種類 | 操作 |
---|---|
仕事 | INSERT UPDATE DELETE START STOP |
SERVER | RE-ENLIST DEFECT SYNC-TIME SET-POLL |
計画 | INSERT UPDATE DELETE |
[ @object_type = ] 'object'
操作をポストする対象のオブジェクトの種類。 有効な型は、 JOB、 SERVER、および SCHEDULE です。 object は varchar(64) で、既定値は JOB です。
[ @job_id = ] job_id
操作が適用されるジョブのジョブ識別番号。 job_id は uniqueidentifier で、既定値はありません。 0x00 は、すべてのジョブを示します。 objectがserverの場合、job_idは必要ありません。
[ @specific_target_server = ] 'target_server'
指定した操作が適用されるターゲット サーバーの名前。 job_idが指定されていても、target_serverが指定されていない場合、ジョブのすべてのジョブ サーバーに対して操作がポストされます。 target_server は nvarchar(30)で、既定値は NULL です。
[ @value = ] value
ポーリング間隔 (秒単位)。 value のデータ型は intで、既定値は NULL です。 このパラメーターは、operation が
[ @schedule_uid = ] schedule_uid
操作が適用されるスケジュールの一意識別子。 schedule_uid は uniqueidentifier で、既定値はありません。
リターン コードの値
0 (成功) または 1 (失敗)
結果セット
なし
解説
sp_post_msx_operation は、 msdb データベースから実行する必要があります。
sp_post_msx_operationは常に安全に呼び出すことができます。これは、現在のサーバーがマルチサーバーの Microsoft SQL Server エージェントであるかどうかを最初に判断し、その場合は、objectがマルチサーバー ジョブであるかどうかを判断するためです。
操作が転記されると、 sysdownloadlist テーブルに表示されます。 ジョブを作成してポストした後、そのジョブに対する後続の変更もターゲット サーバー (TSX) に伝達する必要があります。 これは、ダウンロード リストを使用して行うこともできます。
ダウンロードの一覧は、SQL Server Management Studio を使用して管理することを強くお勧めします。 詳細については、「 ジョブの表示または変更」を参照してください。
アクセス許可
このストアド プロシージャを実行するには、固定サーバー ロール sysadmin をユーザーに付与する必要があります。
参照
sp_add_jobserver (Transact-SQL)
sp_delete_job (Transact-SQL)
sp_delete_jobserver (Transact-SQL)
sp_delete_targetserver (Transact-SQL)
sp_resync_targetserver (Transact-SQL)
sp_start_job (Transact-SQL)
sp_stop_job (Transact-SQL)
sp_update_job (Transact-SQL)
sp_update_operator (Transact-SQL)
システム ストアド プロシージャ (Transact-SQL)