sp_help_jobs_in_schedule (Transact-SQL)

適用対象:SQL Server

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

Transact-SQL 構文表記規則

構文

  
sp_help_jobs_in_schedule   
     [ @schedule_name = ] 'schedule_name' ,  
     [ @schedule_id = ] schedule_id   

引数

[ @schedule_id = ] schedule_id 情報を一覧表示するスケジュールの識別子。 schedule_id は int で、既定値はありません。 schedule_idまたはschedule_nameを指定できます。

[ @schedule_name = ] 'schedule_name' 情報を一覧表示するスケジュールの名前。 schedule_name は sysname で、既定値はありません。 schedule_idまたはschedule_nameを指定できます。

リターン コードの値

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

結果セット

次の結果セットを返します。

列名	データ型	説明
job_id	uniqueidentifier	ジョブの一意の ID。
originating_server	nvarchar(30)	ジョブが送信されたサーバーの名前。
name	sysname	ジョブの名前。
有効	tinyint	ジョブの実行が有効になっているかどうかを示します。
description	nvarchar(512)	ジョブの説明。
start_step_id	int	実行を開始するジョブ内のステップの ID。
category	sysname	ジョブ カテゴリ。
所有者	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 = ジョブにターゲット サーバーがありません。

解説

この手順では、指定したスケジュールに関連付けられているジョブに関する情報を一覧表示します。

アクセス許可

既定では、このストアド プロシージャを実行できるのは、 sysadmin 固定サーバー ロールのメンバーです。 他のユーザーには、 SQL Server msdb データベースの次のいずれかの エージェント固定データベース ロールが許可されている必要があります。

• SQLAgentUserRole

• SQLAgentReaderRole

• SQLAgentOperatorRole

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

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

例

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

USE msdb ;  
GO  
  
EXEC sp_help_jobs_in_schedule  
    @schedule_name = N'NightlyJobs' ;  
GO  

参照

SQL Server エージェントのストアド プロシージャ (Transact-SQL)
sp_add_schedule (Transact-SQL)
sp_attach_schedule (Transact-SQL)
sp_delete_schedule (Transact-SQL)
sp_detach_schedule (Transact-SQL)