sp_post_msx_operation (Transact-SQL)

適用対象: SQL サーバー

ターゲット サーバーがダウンロードして実行できるように、 sysdownloadlist システム テーブルに操作 (行) を挿入します。

Transact-SQL 構文表記規則

構文

  
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 が SET-POLL の場合にのみ指定します。

[ @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)