sp_help_downloadlist (Transact-SQL)
適用対象:SQL Server
指定されたジョブの sysdownloadlist システム テーブル内のすべての行、またはジョブが指定されていない場合はすべての行を一覧表示します。
構文
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
参照
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示