sp_help_downloadlist (Transact-SQL)

適用対象:SQL Server

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

Transact-SQL 構文表記規則

構文

sp_help_downloadlist
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @operation = ] 'operation' ]
    [ , [ @object_type = ] 'object_type' ]
    [ , [ @object_name = ] N'object_name' ]
    [ , [ @target_server = ] N'target_server' ]
    [ , [ @has_error = ] has_error ]
    [ , [ @status = ] status ]
    [ , [ @date_posted = ] date_posted ]
[ ; ]

引数

[ @job_id = ] 'job_id'

情報を返すジョブの識別番号を指定します。 @job_idは uniqueidentifier で、既定値は NULL.

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

[ @job_name = ] N'job_name'

ジョブの名前。 @job_nameは sysname で、既定値は NULL.

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

[ @operation = ] 'operation'

指定したジョブに有効な操作を指定します。 @operationは varchar(64) であり、これらの値のいずれかを指定できます。

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

[ @object_type = ] 'object_type'

指定したジョブのオブジェクトの型。 @object_typeは varchar(64) で、既定値は NULL. @object_typeは、いずれか 1 つまたは SERVER2 つJOBを指定できます。 有効な@object_type値の詳細については、sp_add_categoryを参照してください。

[ @object_name = ] N'object_name'

オブジェクトの名前。 @object_nameは sysname で、既定値は NULL. @object_typeが指定されている場合、JOB@object_nameはジョブ名です。 @object_typeが指定されている場合、SERVER@object_nameはサーバー名です。

[ @target_server = ] N'target_server'

ターゲット サーバーの名前。 @target_serverは sysname で、既定値は NULL.

[ @has_error = ] has_error

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

[ @status = ] 状態

ジョブの状態を指定します。 @statusは tinyint で、既定値は NULL.

[ @date_posted = ] date_posted

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

リターン コードの値

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

結果セット

列名	データ型	説明
instance_id	int	命令の一意な整数識別番号。
source_server	nvarchar(30)	命令の元のサーバーのコンピューター名。
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)