sp_help_downloadlist (Transact-SQL)

  • [アーティクル]

適用対象:SQL Server

指定されたジョブの sysdownloadlist システム テーブル内のすべての行、またはジョブが指定されていない場合はすべての行を一覧表示します。

Transact-SQL 構文表記規則

構文

  
sp_help_downloadlist { [ @job_id = ] job_id | [ @job_name = ] 'job_name' }   
     [ , [ @operation = ] 'operation' ]   
     [ , [ @object_type = ] 'object_type' ]   
     [ , [ @object_name = ] 'object_name' ]   
     [ , [ @target_server = ] 'target_server' ]   
     [ , [ @has_error = ] has_error ]   
     [ , [ @status = ] status ]   
     [ , [ @date_posted = ] date_posted ]

引数

[ @job_id = ] job_id 情報を返すジョブ識別番号。 job_id は uniqueidentifier で、既定値は NULL です。

[ @job_name = ] 'job_name' ジョブの名前。 job_name は sysname で、既定値は NULL です。

注意

job_idまたはjob_nameを指定する必要がありますが、両方を指定することはできません。

[ @operation = ] 'operation' 指定したジョブの有効な操作。 operation は varchar(64)で、既定値は NULL で、これらの値のいずれかを指定できます。

値 説明
欠陥 ターゲット サーバーにマスター SQLServerAgent サービスからの障害を要求するサーバー操作。
DELETE ジョブ全体を削除するジョブ操作。
INSERT ジョブ全体の追加、または既存のジョブの更新を行うジョブ操作。 この操作には、必要に応じて、すべてのジョブ ステップとスケジュールが含まれます。
RE-ENLIST ターゲット サーバーで参加情報の再送信を行うためのサーバー操作。この情報にはマルチサーバー ドメインのポーリング間隔やタイム ゾーンも含まれます。 ターゲット サーバーは 、MSXOperator の詳細も再ダウンロードします。
SET-POLL ターゲット サーバーがマルチサーバー ドメインを呼び出す間隔を秒単位で設定するサーバー操作。 指定した場合、値は必要な間隔値として解釈され、10 から 28,800 までの値を指定できます。
開始 ジョブ実行の開始を要求するジョブ操作。
停止 ジョブ実行の停止を要求するジョブ操作。
SYNC-TIME ターゲット サーバーがシステム クロックをマルチサーバー ドメインと同期させるサーバー操作。 これはコストのかかる操作であるため、この操作は限られた頻度で実行してください。
UPDATE ジョブステップやスケジュールではなく、ジョブの sysjobs 情報のみを更新するジョブ操作。 sp_update_jobによって自動的に呼び出されます。

[ @object_type = ] 'object_type' 指定したジョブのオブジェクトの型。 object_type は varchar(64)で、既定値は NULL です。 object_type には、JOB または SERVER のいずれかを指定できます。 有効な object_type値の詳細については、「 sp_add_category (Transact-SQL)」を参照してください。

[ @object_name = ] 'object_name' オブジェクトの名前。 object_name は sysname で、既定値は NULL です。 object_typeが JOB の場合、object_nameはジョブ名です。 object_typeが SERVER の場合、object_nameはサーバー名です。

[ @target_server = ] 'target_server' ターゲット サーバーの名前。 target_server は nvarchar(128)、既定値は NULL です。

[ @has_error = ] has_error ジョブでエラーを確認する必要があるかどうかを指定します。 has_error は tinyint で、既定値は NULL で、エラーを確認する必要がないことを示します。 1 は 、すべてのエラーを確認する必要があることを示します。

[ @status = ] status ジョブの状態。 status は tinyint で、既定値は NULL です。

[ @date_posted = ] date_posted 指定した日時以降に行われたすべてのエントリを結果セットに含める日付と時刻。 date_posted は datetime で、既定値は NULL です。

リターン コードの値

0 (成功) または 1 (失敗)

結果セット

列名 データ型 説明
instance_id int 命令の一意な整数識別番号。
source_server nvarchar(30) 命令の取得元のサーバーのコンピューター名。 Microsoft SQL Server バージョン 7.0 では、これは常にマスター (MSX) サーバーのコンピューター名です。
operation_code nvarchar (4000) 命令の操作コード。
object_name sysname 命令の影響を受けるオブジェクト。
object_id uniqueidentifier 命令の影響を受けるオブジェクトの識別番号 (ジョブ オブジェクトのjob_id 、またはサーバー オブジェクトの0x00) または operation_codeに固有のデータ値。
target_server nvarchar(30) この命令をダウンロードするターゲット サーバー。
error_message nvarchar(1024) この命令の処理中に問題が発生した場合の、ターゲット サーバーからのエラー メッセージ (存在する場合)。

注: エラー メッセージは、ターゲット サーバーによるそれ以降のすべてのダウンロードをブロックします。
date_posted datetime 命令がテーブルに投稿された日付。
date_downloaded datetime ターゲット サーバーが命令をダウンロードした日付。
status tinyint ジョブの状態:

0 = まだダウンロードされていません

1 = 正常にダウンロードされました。

アクセス許可

このプロシージャの実行権限は、既定では sysadmin 固定サーバー ロールのメンバーに与えられています。

例

次の例では、sysdownloadlist 内の NightlyBackups ジョブに関する行を一覧表示します。

USE msdb ;  
GO  
  
EXEC dbo.sp_help_downloadlist  
    @job_name = N'NightlyBackups',  
    @operation = N'UPDATE',   
    @object_type = N'JOB',   
    @object_name = N'NightlyBackups',  
    @target_server = N'SEATTLE2',   
    @has_error = 1,   
    @status = NULL,   
    @date_posted = NULL ;  
GO

参照

システム ストアド プロシージャ (Transact-SQL)