Share via

sp_help_jobs_in_schedule (Transact-SQL)

  • [アーティクル]

適用対象:SQL Server

特定のスケジュールがアタッチされているジョブに関する情報を返します。

Transact-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 = Never
1 = ジョブが成功した場合
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 のアップグレード中にこれらのアクセス許可がオーバーライドされる可能性があります。

他のユーザーには、データベース内の固定データベース ロールSQL Server エージェント次のいずれかを付与するmsdb必要があります。

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

これらのロールの権限の詳細については、「 SQL Server エージェントの固定データベース ロール」を参照してください。

SQLAgentUserRole のメンバーは、所有しているジョブの状態のみを表示できます。

例

次の例では、NightlyJobs スケジュールにアタッチされたジョブを一覧表示します。

USE msdb;
GO

EXEC sp_help_jobs_in_schedule
    @schedule_name = N'NightlyJobs';
GO

関連するコンテンツ