sp_help_downloadlist (Transact-SQL)
適用対象: 
SQL Server
指定されたジョブの sysdownloadlist システム テーブル内のすべての行、またはジョブが指定されていない場合は、すべての行を一覧表示します。
構文
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)であり、これらの値のいずれかを指定できます。
| 値 | 説明 |
|---|---|
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 は、 JOB または SERVERにすることができます。 有効な @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
ジョブの状態を指定します。 @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