sp_help_jobs_in_schedule (Transact-SQL)sp_help_jobs_in_schedule (Transact-SQL)

適用対象: yesSQL Server noAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

特定のスケジュールがアタッチされるジョブに関する情報を返します。Returns information about the jobs that a particular schedule is attached to.

トピック リンク アイコン Transact-SQL 構文表記規則Topic link icon Transact-SQL Syntax Conventions

構文Syntax

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

引数Arguments

[ @schedule_id = ] schedule_id に関する情報を表示するスケジュールの識別子です。[ @schedule_id = ] schedule_id The identifier of the schedule to list information for. schedule_idint、既定値はありません。schedule_id is int, with no default. いずれかschedule_idまたはschedule_name指定することがあります。Either schedule_id or schedule_name may be specified.

[ @schedule_name = ] 'schedule_name' に関する情報を表示するスケジュールの名前。[ @schedule_name = ] 'schedule_name' The name of the schedule to list information for. schedule_namesysname、既定値はありません。schedule_name is sysname, with no default. いずれかschedule_idまたはschedule_name指定することがあります。Either schedule_id or schedule_name may be specified.

リターン コードの値Return Code Values

0 (成功) または1 (失敗)0 (success) or 1 (failure)

結果セットResult Sets

次の結果セットを返します。Returns the following result set:

列名Column name データ型Data type 説明Description
job_idjob_id uniqueidentifieruniqueidentifier ジョブの一意な ID。Unique ID of the job.
originating_serveroriginating_server nvarchar(30)nvarchar(30) ジョブを実行したサーバーの名前。Name of the server from which the job came.
namename sysnamesysname ジョブの名前。Name of the job.
enabledenabled tinyinttinyint ジョブが実行可能かどうか。Indicates whether the job is enabled to be executed.
descriptiondescription nvarchar(512)nvarchar(512) ジョブの説明。Description for the job.
start_step_idstart_step_id intint 実行を開始するジョブ ステップの ID。ID of the step in the job where execution should begin.
categorycategory sysnamesysname ジョブ カテゴリ。Job category.
所有者owner sysnamesysname ジョブ所有者。Job owner.
notify_level_eventlognotify_level_eventlog intint どのような場合に通知イベントを Microsoft Windows アプリケーション ログに記録するかを示すビットマスク。Bitmask indicating under what circumstances a notification event should be logged to the Microsoft Windows application log. これらの値のいずれかを指定できます。Can be one of these values:

0 = なし0 = Never

1 = ジョブが成功した場合1 = When a job succeeds

2 = ジョブが失敗したとき2 = When the job fails

3 = (ジョブの結果に関係なく、ジョブが終了したとき3 = Whenever the job completes (regardless of the job outcome)
notify_level_emailnotify_level_email intint どのような場合に、ジョブの完了時に通知電子メールを送信するのかを示すビットマスク。Bitmask indicating under what circumstances a notification e-mail should be sent when a job completes. 指定できる値は同じであるnotify_level_eventlogします。Possible values are the same as for notify_level_eventlog.
notify_level_netsendnotify_level_netsend intint どのような場合に、ジョブの完了時にネットワーク メッセージを送信するのかを示すビットマスク。Bitmask indicating under what circumstances a network message should be sent when a job completes. 指定できる値は同じであるnotify_level_eventlogします。Possible values are the same as for notify_level_eventlog.
notify_level_pagenotify_level_page intint どのような場合に、ジョブの完了時にページを送信するのかを示すビットマスク。Bitmask indicating under what circumstances a page should be sent when a job completes. 指定できる値は同じであるnotify_level_eventlogします。Possible values are the same as for notify_level_eventlog.
notify_email_operatornotify_email_operator sysnamesysname 通知先のオペレーターの電子メール名。E-mail name of the operator to notify.
notify_netsend_operatornotify_netsend_operator sysnamesysname ネットワーク メッセージを送信するときに使用するコンピューターまたはユーザーの名前。Name of the computer or user used when sending network messages.
notify_page_operatornotify_page_operator sysnamesysname ページを送信するときに使用するコンピューターまたはユーザーの名前。Name of the computer or user used when sending a page.
delete_leveldelete_level intint どのような場合に、ジョブの完了時にジョブを削除するのかを示すビットマスク。Bitmask indicating under what circumstances the job should be deleted when a job completes. 指定できる値は同じであるnotify_level_eventlogします。Possible values are the same as for notify_level_eventlog.
date_createddate_created datetimedatetime ジョブを作成した日付。Date the job was created.
date_modifieddate_modified datetimedatetime ジョブを最後に変更した日付。Date the job was last modified.
version_numberversion_number intint ジョブのバージョン。ジョブを変更するたびに自動的に更新されます。Version of the job (automatically updated each time the job is modified).
last_run_datelast_run_date intint ジョブの実行を最後に開始した日付。Date the job last started execution.
last_run_timelast_run_time intint ジョブの実行を最後に開始した時刻。Time the job last started execution.
last_run_outcomelast_run_outcome intint 最後に実行したときのジョブの結果。Outcome of the job the last time it ran:

0 = に失敗しました0 = Failed

1 = に成功しました1 = Succeeded

3 = キャンセル3 = Canceled

5 = unknown5 = Unknown
next_run_datenext_run_date intint ジョブの次回実行予定日。Date the job is scheduled to run next.
next_run_timenext_run_time intint ジョブの次回実行予定時刻。Time the job is scheduled to run next.
next_run_schedule_idnext_run_schedule_id intint 次回の実行スケジュールの識別番号。Identification number of the next run schedule.
current_execution_statuscurrent_execution_status intint 現在の実行ステータス。Current execution status.
current_execution_stepcurrent_execution_step sysnamesysname ジョブの現在の実行ステップ。Current execution step in the job.
current_retry_attemptcurrent_retry_attempt intint ジョブの実行中にステップを再試行した場合、現在の再試行を示します。If the job is running and the step has been retried, this is the current retry attempt.
has_stephas_step intint ジョブのジョブ ステップ数。Number of job steps the job has.
has_schedulehas_schedule intint ジョブのジョブ スケジュール数。Number of job schedules the job has.
has_targethas_target intint ジョブのターゲット サーバー数。Number of target servers the job has.
typetype intint ジョブの種類:Type of the job:

1 = ローカル ジョブ。1 = Local job.

2 = マルチ サーバー ジョブです。2 = Multiserver job.

0 = ジョブには、対象サーバーがありません。0 = Job has no target servers.

コメントRemarks

このプロシージャでは、指定されたスケジュールにアタッチされたジョブに関する情報が一覧表示されます。This procedure lists information about jobs attached to the specified schedule.

アクセス許可Permissions

既定では、このストアド プロシージャを実行できるのは、 sysadmin 固定サーバー ロールのメンバーです。By default, members of the sysadmin fixed server role can execute this stored procedure. 他のユーザーには、 SQL ServerSQL Server msdb データベースの次のいずれかの エージェント固定データベース ロールが許可されている必要があります。Other users must be granted one of the following SQL ServerSQL Server Agent fixed database roles in the msdb database:

  • SQLAgentUserRoleSQLAgentUserRole

  • SQLAgentReaderRoleSQLAgentReaderRole

  • SQLAgentOperatorRoleSQLAgentOperatorRole

これらのロールの権限の詳細については、「 SQL Server エージェントの固定データベース ロール」を参照してください。For details about the permissions of these roles, see SQL Server Agent Fixed Database Roles.

メンバーのSQLAgentUserRole自分が所有するジョブの状態のみを表示できます。Members of SQLAgentUserRole can only view the status of jobs that they own.

使用例Examples

次の例では、NightlyJobs スケジュールにアタッチされたジョブを一覧表示します。The following example lists the jobs attached to the NightlyJobs schedule.

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

参照See Also

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