sp_help_jobs_in_schedule (Transact-SQL)
適用対象: SQL サーバー
特定のスケジュールがアタッチされているジョブに関する情報を返します。
構文
sp_help_jobs_in_schedule
[ [ @schedule_name = ] N'schedule_name' ]
[ , [ @schedule_id = ] schedule_id ]
[ ; ]
引数
[ @schedule_id = ] schedule_id
情報を一覧表示するスケジュールの識別子を指定します。 @schedule_id は int で、既定値は NULL
です。
@schedule_idまたは@schedule_nameを指定できます。
[ @schedule_name = ] N'schedule_name'
情報を一覧表示するスケジュールの名前。 @schedule_name は sysname で、既定値は NULL
です。
@schedule_idまたは@schedule_nameを指定できます。
リターン コードの値
0
(成功) または 1
(失敗)。
結果セット
次の結果セットを返します。
列名 | データ型 | 説明 |
---|---|---|
job_id |
uniqueidentifier | ジョブの一意の ID。 |
originating_server |
nvarchar(30) | ジョブが実行されたサーバーの名前。 |
name |
sysname | ジョブの名前。 |
enabled |
tinyint | ジョブを実行できるように、ジョブが有効になっているかどうかを示します。 |
description |
nvarchar(512) | ジョブの説明。 |
start_step_id |
int | 実行を開始するジョブ内のステップの ID。 |
category |
sysname | ジョブ カテゴリ。 |
owner |
sysname | ジョブ所有者。 |
notify_level_eventlog |
int | 通知イベントを Microsoft Windows アプリケーション ログに記録する必要がある状況を示すビットマスク。 次のいずれかの値を指定します。0 = Never1 = ジョブが成功した場合2 = ジョブが失敗した場合3 = ジョブが完了するたびに (ジョブの結果に関係なく) |
notify_level_email |
int | ジョブの完了時に通知電子メールを送信する必要がある状況を示すビットマスク。 指定できる値は、 notify_level_eventlog の場合と同じです。 |
notify_level_netsend |
int | ジョブの完了時にネットワーク メッセージを送信する必要がある状況を示すビットマスク。 指定できる値は、 notify_level_eventlog の場合と同じです。 |
notify_level_page |
int | どのような場合に、ジョブの完了時にページを送信するのかを示すビットマスク。 指定できる値は、 notify_level_eventlog の場合と同じです。 |
notify_email_operator |
sysname | 通知するオペレーターの電子メール名。 |
notify_netsend_operator |
sysname | ネットワーク メッセージを送信するときに使用するコンピューターまたはユーザーの名前。 |
notify_page_operator |
sysname | ページを送信するときに使用するコンピューターまたはユーザーの名前。 |
delete_level |
int | ジョブが完了したときにジョブを削除する必要がある状況を示すビットマスク。 指定できる値は、 notify_level_eventlog の場合と同じです。 |
date_created |
datetime | ジョブが作成された日付。 |
date_modified |
datetime | ジョブが最後に変更された日付。 |
version_number |
int | ジョブのバージョン (ジョブを変更するたびに自動的に更新されます)。 |
last_run_date |
int | ジョブが最後に実行を開始した日付。 |
last_run_time |
int | ジョブが最後に実行を開始した時刻。 |
last_run_outcome |
int | 前回実行されたジョブの結果:0 = 失敗1 = 成功3 = キャンセル済み5 = 不明 |
next_run_date |
int | ジョブが次に実行されるようにスケジュールされている日付。 |
next_run_time |
int | ジョブの次回実行予定時刻。 |
next_run_schedule_id |
int | 次回の実行スケジュールの識別番号。 |
current_execution_status |
int | 現在の実行状態。 |
current_execution_step |
sysname | ジョブの現在の実行ステップ。 |
current_retry_attempt |
int | ジョブが実行中で、ステップが再試行された場合、この値は現在の再試行です。 |
has_step |
int | ジョブに含まれるジョブ ステップの数。 |
has_schedule |
int | ジョブのジョブ スケジュール数。 |
has_target |
int | ジョブのターゲット サーバー数。 |
type |
int | ジョブの種類:1 = ローカル ジョブ。2 = マルチサーバー ジョブ。0 = ジョブにターゲット サーバーがありません。 |
解説
この手順では、指定したスケジュールにアタッチされたジョブに関する情報を一覧表示します。
アクセス許可
このストアド プロシージャは、 db_owner ロールによって所有されています。 EXECUTE
アクセス許可は任意のユーザーに付与できますが、SQL Server のアップグレード中にこれらのアクセス許可がオーバーライドされる可能性があります。
他のユーザーには、msdb
データベース内の次SQL Server エージェント固定データベース ロールのいずれかを付与する必要があります。
- SQLAgentUserRole
- SQLAgentReaderRole
- SQLAgentOperatorRole
これらのロールの権限の詳細については、「 SQL Server エージェントの固定データベース ロール」を参照してください。
SQLAgentUserRoleのメンバーは、所有しているジョブの状態のみを表示できます。
例
次の例では、NightlyJobs
スケジュールにアタッチされたジョブを一覧表示します。
USE msdb;
GO
EXEC sp_help_jobs_in_schedule
@schedule_name = N'NightlyJobs';
GO