sp_help_jobschedule (TRANSACT-SQL)sp_help_jobschedule (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

によって使用されるジョブのスケジュールに関する情報を返しますSQL Server Management StudioSQL Server Management Studio自動化された操作を実行します。Returns information about the scheduling of jobs used by SQL Server Management StudioSQL Server Management Studio to perform automated activities.

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

構文Syntax

  
sp_help_jobschedule { [ @job_id = ] job_id | [ @job_name = ] 'job_name' }  
     [ , [ @schedule_name = ] 'schedule_name' ]  
     [ , [ @schedule_id = ] schedule_id ]  
     [ , [ @include_description = ] include_description ]  

引数Arguments

[ @job_id = ] job_id ジョブの識別番号。[ @job_id = ] job_id The job identification number. job_iduniqueidentifier、既定値は NULL です。job_idis uniqueidentifier, with a default of NULL.

[ @job_name = ] 'job_name' ジョブの名前。[ @job_name = ] 'job_name' The name of the job. job_namesysname、既定値は NULL です。job_nameis sysname, with a default of NULL.

注意

いずれかjob_idまたはjob_name指定する必要がありますが、両方を指定することはできません。Either job_id or job_name must be specified, but both cannot be specified.

[ @schedule_name = ] 'schedule_name' ジョブのスケジュール アイテムの名前。[ @schedule_name = ] 'schedule_name' The name of the schedule item for the job. schedule_namesysname、既定値は NULL です。schedule_nameis sysname, with a default of NULL.

[ @schedule_id = ] schedule_id ジョブのスケジュール アイテムの識別番号。[ @schedule_id = ] schedule_id The identification number of the schedule item for the job. schedule_idint、既定値は NULL です。schedule_idis int, with a default of NULL.

[ @include_description = ] include_description スケジュールの説明を結果セットに含めるかどうかを指定します。[ @include_description = ] include_description Specifies whether to include the description of the schedule in the result set. include_descriptionビット、既定値は0します。include_description is bit, with a default of 0. ときにinclude_description0スケジュールの説明が結果セットに含まれません。When include_description is 0, the description of the schedule is not included in the result set. ときにinclude_description1、結果セットのスケジュールの説明が含まれます。When include_description is 1, the description of the schedule is included in the result set.

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

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

結果セットResult Sets

列名Column name データ型Data type 説明Description
schedule_idschedule_id intint スケジュールの識別番号。Schedule identifier number.
schedule_nameschedule_name sysnamesysname スケジュールの名前。Name of the schedule.
enabledenabled intint スケジュールが有効かどうか (1) または有効になっていません (0)。Whether the schedule enabled (1) or not enabled (0).
freq_typefreq_type intint ジョブが実行されることを示す値。Value indicating when the job is to be executed.

1 = 1 回1 = Once

4 = 毎日4 = Daily

8 = 毎週8 = Weekly

16毎月を =16 = Monthly

32を基準とする、毎月を =、 freq_interval32 = Monthly, relative to the freq_interval

64 = の場合に実行SQLServerAgentサービスの開始。64 = Run when SQLServerAgent service starts.
freq_intervalfreq_interval intint 日のジョブを実行するとします。Days when the job is executed. 値の値に依存freq_typeします。The value depends on the value of freq_type. 詳細については、次を参照してください。 sp_add_schedule (TRANSACT-SQL)します。For more information, see sp_add_schedule (Transact-SQL).
freq_subday_typefreq_subday_type intint 単位freq_subday_intervalします。Units for freq_subday_interval. 詳細については、次を参照してください。 sp_add_schedule (TRANSACT-SQL)します。For more information, see sp_add_schedule (Transact-SQL).
freq_subday_intervalfreq_subday_interval intint freq_subday_typeにジョブの各実行間に発生する期間。Number of freq_subday_type periods to occur between each execution of the job. 詳細については、次を参照してください。 sp_add_schedule (TRANSACT-SQL)します。For more information, see sp_add_schedule (Transact-SQL).
freq_relative_intervalfreq_relative_interval intint 定期ジョブのfreq_interval各月にします。Scheduled job's occurrence of the freq_interval in each month. 詳細については、次を参照してください。 sp_add_schedule (TRANSACT-SQL)します。For more information, see sp_add_schedule (Transact-SQL).
freq_recurrence_factorfreq_recurrence_factor intint 定期ジョブの実行間隔 (月単位)。Number of months between the scheduled execution of the job.
active_start_dateactive_start_date intint スケジュールをアクティブにした日付。Date the schedule is activated.
active_end_dateactive_end_date intint スケジュールの終了日。End date of the schedule.
active_start_timeactive_start_time intint スケジュールの開始時刻。Time of the day the schedule starts.
active_end_timeactive_end_time intint スケジュールを終了する時刻。Time of the day schedule ends.
date_createddate_created datetimedatetime スケジュールを作成した日付。Date the schedule is created.
schedule_descriptionschedule_description nvarchar (4000)nvarchar(4000) 内の値から派生したスケジュールの説明msdb.dbo.sysschedulesします。An English description of the schedule that is derived from values in msdb.dbo.sysschedules. ときにinclude_description0、このコラムには、説明が要求されていないことを示すテキストが含まれています。When include_description is 0, this column contains text stating that the description was not requested.
next_run_datenext_run_date intint スケジュールで次にジョブを実行する日付。Date the schedule will next cause the job to run.
next_run_timenext_run_time intint スケジュールで次にジョブを実行する時刻。Time the schedule will next cause the job to run.
schedule_uidschedule_uid uniqueidentifieruniqueidentifier スケジュールの識別子。Identifier for the schedule.
job_countjob_count intint ジョブの数が返されます。Count of jobs returned.

注: sp_help_jobscheduleから値を返します、ではdbo.sysschedulesシステム テーブルmsdbします。NOTE: sp_help_jobschedule returns values from the dbo.sysjobschedules and dbo.sysschedules system tables in msdb. sysjobschedules 20 分ごとに更新します。sysjobschedules updates every 20 minutes. このストアド プロシージャによって返される値に影響を与える可能性があります。This might affect the values that are returned by this stored procedure.

コメントRemarks

パラメーター sp_help_jobschedule特定の組み合わせでのみ使用できます。The parameters of sp_help_jobschedule can be used only in certain combinations. 場合schedule_idが指定されてもjob_idjob_nameを指定できます。If schedule_id is specified, neither job_id nor job_name can be specified. それ以外の場合、 job_idまたはjob_nameでパラメーターを使用できるschedule_nameします。Otherwise, the job_id or job_name parameters can be used with schedule_name.

アクセス許可Permissions

sysadmin 固定サーバー ロールのメンバーシップが必要です。Requires membership in the sysadmin fixed server role. 他のユーザーには、 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 properties of job schedules that they own.

使用例Examples

A.A. 特定のジョブのジョブ スケジュールを返すReturning the job schedule for a specific job

次の例は、という名前のジョブのスケジュール情報を返しますBackupDatabaseします。The following example returns the scheduling information for a job named BackupDatabase.

USE msdb ;  
GO  
  
EXEC dbo.sp_help_jobschedule  
    @job_name = N'BackupDatabase' ;  
GO  

B.B. 特定のスケジュールのジョブ スケジュールを返すReturning the job schedule for a specific schedule

次の例では、NightlyJobs という名前のスケジュールと、RunReports という名前のジョブの情報を返します。The following example returns the information for the schedule named NightlyJobs and the job named RunReports.

USE msdb ;  
GO  
  
EXEC dbo.sp_help_jobschedule   
    @job_name = N'RunReports',  
    @schedule_name = N'NightlyJobs' ;  
GO  

C.C. ジョブのスケジュールと特定のスケジュールのスケジュールの説明を取得します。Returning the job schedule and schedule description for a specific schedule

次の例では、NightlyJobs という名前のスケジュールと、RunReports という名前のジョブの情報を返します。The following example returns the information for the schedule named NightlyJobs and the job named RunReports. 返される結果には、スケジュールの説明が含まれています。The result set returned includes a description of the schedule.

USE msdb ;  
GO  
  
EXEC dbo.sp_help_jobschedule  
    @job_name = N'RunReports',  
    @schedule_name = N'NightlyJobs',  
    @include_description = 1 ;  
GO  

参照See Also

sp_add_schedule (TRANSACT-SQL) sp_add_schedule (Transact-SQL)
sp_delete_schedule (TRANSACT-SQL) sp_delete_schedule (Transact-SQL)
sp_update_schedule (TRANSACT-SQL) sp_update_schedule (Transact-SQL)
システム ストアド プロシージャ (Transact-SQL)System Stored Procedures (Transact-SQL)