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 = ジョブにターゲット サーバーがありません。

解説

この手順では、指定したスケジュールにアタッチされたジョブに関する情報を一覧表示します。

アクセス許可

この手順では 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

関連するコンテンツ

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