sp_update_schedule (Transact-SQL)sp_update_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

設定を変更、SQL ServerSQL Serverエージェント スケジュール。Changes the settings for a SQL ServerSQL Server Agent schedule.

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

構文Syntax

  
sp_update_schedule   
    {   [ @schedule_id = ] schedule_id   
      | [ @name = ] 'schedule_name' }  
    [ , [ @new_name = ] new_name ]  
    [ , [ @enabled = ] enabled ]  
    [ , [ @freq_type = ] freq_type ]  
    [ , [ @freq_interval = ] freq_interval ]   
    [ , [ @freq_subday_type = ] freq_subday_type ]   
    [ , [ @freq_subday_interval = ] freq_subday_interval ]   
    [ , [ @freq_relative_interval = ] freq_relative_interval ]   
    [ , [ @freq_recurrence_factor = ] freq_recurrence_factor ]   
    [ , [ @active_start_date = ] active_start_date ]   
    [ , [ @active_end_date = ] active_end_date ]   
    [ , [ @active_start_time = ] active_start_time ]   
    [ , [ @active_end_time = ] active_end_time ]   
    [ , [ @owner_login_name = ] 'owner_login_name' ]  
    [ , [ @automatic_post =] automatic_post ]  

引数Arguments

[ @schedule_id = ] schedule_id 変更するスケジュールの識別子。[ @schedule_id = ] schedule_id The identifier of the schedule to modify. schedule_idint、既定値はありません。schedule_id is int, with no default. いずれかschedule_idまたはschedule_name指定する必要があります。Either schedule_id or schedule_name must be specified.

[ @name = ] 'schedule_name' 変更するスケジュールの名前。[ @name = ] 'schedule_name' The name of the schedule to modify. schedule_namesysname、既定値はありません。schedule_nameis sysname, with no default. いずれかschedule_idまたはschedule_name指定する必要があります。Either schedule_id or schedule_name must be specified.

[ @new_name = ] new_name スケジュールの新しい名前。[ @new_name = ] new_name The new name for the schedule. 新しい名前sysname、既定値は NULL です。new_name is sysname, with a default of NULL. ときにnew_nameが null の場合、スケジュールの名前は変更されません。When new_name is NULL, the name of the schedule is unchanged.

[ @enabled = ] enabled スケジュールの現在の状態を示します。[ @enabled = ] enabled Indicates the current status of the schedule. 有効になっているtinyint、既定値は1 (有効)。enabledis tinyint, with a default of 1 (enabled). 場合0スケジュールが有効になっていません。If 0, the schedule is not enabled. スケジュールが有効でない場合、このスケジュールでジョブは実行されません。When the schedule is not enabled, no jobs will run on this schedule.

[ @freq_type = ] freq_type ジョブの場合は、実行することを示す値。[ @freq_type = ] freq_type A value indicating when a job is to be executed. freq_typeint、既定値は0、これらの値のいずれかを指定できます。freq_typeis int, with a default of 0, and can be one of these values.

Value 説明Description
11 1 回。Once
44 毎日。Daily
88 毎週。Weekly
1616 毎月。Monthly
3232 毎月、に対して相対的なfreq 間隔Monthly, relative to freq interval
6464 SQLServerAgent サービスの起動時に実行します。Run when SQLServerAgent service starts
128128 コンピューターがアイドル状態のときに実行します。Run when the computer is idle

[ @freq_interval = ] freq_interval ジョブを実行する日です。[ @freq_interval = ] freq_interval The days that a job is executed. freq_intervalint、既定値は0の値に依存してfreq_typeします。freq_interval is int, with a default of 0, and depends on the value of freq_type.

freq_typeValue of freq_type 影響を与えるfreq_intervalEffect on freq_interval
1 (1 回)1 (once) freq_intervalは使用されません。freq_interval is unused.
4 (毎日)4 (daily) すべてfreq_interval日。Every freq_interval days.
8 (毎週)8 (weekly) freq_intervalは、次の 1 つ以上 (と組み合わせて、 OR論理演算子)。freq_interval is one or more of the following (combined with an OR logical operator):

1日曜日を =1 = Sunday

2 = 月曜日2 = Monday

4 = 火曜日4 = Tuesday

8 = 水曜日8 = Wednesday

16 = 木曜日16 = Thursday

32 = 金曜日32 = Friday

64 = 土曜日64 = Saturday
16 (毎月)16 (monthly) Freq_intervalします月の日。On the freq_interval day of the month.
32 (月単位)32 (monthly relative) freq_intervalは、次の 1 つです。freq_interval is one of the following:

1日曜日を =1 = Sunday

2 = 月曜日2 = Monday

3 = 火曜日3 = Tuesday

4 = 水曜日4 = Wednesday

5 = 木曜日5 = Thursday

6 = 金曜日6 = Friday

7 = 土曜日7 = Saturday

8 = 日8 = Day

9 = 平日9 = Weekday

10 = 土日10 = Weekend day
64 (SQLServerAgent サービスの開始時)64 (when SQLServerAgent service starts) freq_intervalは使用されません。freq_interval is unused.
128128 freq_intervalは使用されません。freq_interval is unused.

[ @freq_subday_type = ] freq_subday_type 単位を指定します ** * freq_subday_interval です。*[ @freq_subday_type = ] freq_subday_type Specifies the units for freq_subday_interval**. freq_subday_typeint、既定値は0、これらの値のいずれかを指定できます。freq_subday_typeis int, with a default of 0, and can be one of these values.

Value 説明 (単位)Description (unit)
0x10x1 指定された時刻At the specified time
0x20x2 SecondsSeconds
0x40x4 MinutesMinutes
0x80x8 HoursHours

[ @freq_subday_interval = ] freq_subday_intervalfreq_subday_typeにジョブの各実行間に発生する期間。[ @freq_subday_interval = ] freq_subday_interval The number of freq_subday_type periods to occur between each execution of a job. freq_subday_intervalint、既定値は0します。freq_subday_intervalis int, with a default of 0.

[ @freq_relative_interval = ] freq_relative_interval ジョブの発生freq_interval 、各月場合freq_interval32 (月単位)。[ @freq_relative_interval = ] freq_relative_interval A job's occurrence of freq_interval in each month, if freq_interval is 32 (monthly relative). freq_relative_intervalint、既定値は0、これらの値のいずれかを指定できます。freq_relative_intervalis int, with a default of 0, and can be one of these values.

Value 説明 (単位)Description (unit)
11 FirstFirst
22 第 2 週Second
44 サードパーティThird
88 4 番目Fourth
1616 LastLast

[ @freq_recurrence_factor = ] freq_recurrence_factor 週間隔または月間隔は、ジョブのスケジュールされた実行の数。[ @freq_recurrence_factor = ] freq_recurrence_factor The number of weeks or months between the scheduled execution of a job. freq_recurrence_factor場合にのみ使用がfreq_type816、または32します。freq_recurrence_factor is used only if freq_type is 8, 16, or 32. freq_recurrence_factorint、既定値は0します。freq_recurrence_factoris int, with a default of 0.

[ @active_start_date = ] active_start_date ジョブの実行が開始できる日付。[ @active_start_date = ] active_start_date The date on which execution of a job can begin. active_start_dateintの既定値は NULL には、今日の日付を示します。active_start_dateis int, with a default of NULL, which indicates today's date. 日付は yyyymmdd です。The date is formatted as YYYYMMDD. 場合active_start_dateが NULL でない日付は 19900101 以上する必要があります。If active_start_date is not NULL, the date must be greater than or equal to 19900101.

スケジュールを作成した後は、開始日を確認し、正しい日付であることを確認します。After the schedule is created, review the start date and confirm that it is the correct date. 詳細については、「開始日のスケジュール設定」セクションを参照してくださいの作成とジョブ スケジュールをアタッチします。For more information, see the section "Scheduling Start Date" in Create and Attach Schedules to Jobs.

[ @active_end_date = ] active_end_date ジョブの実行が停止できる日付。[ @active_end_date = ] active_end_date The date on which execution of a job can stop. active_end_dateint、既定値は99991231、示す年 12 月 31 日 9999 です。active_end_dateis int, with a default of 99991231, which indicates December 31, 9999. Yyyymmdd 形式で指定として書式設定します。Formatted as YYYYMMDD.

[ @active_start_time = ] active_start_time 間の日で時間active_start_dateactive_end_dateジョブの実行を開始します。[ @active_start_time = ] active_start_time The time on any day between active_start_date and active_end_date to begin execution of a job. active_start_timeint12時 00分: 00 AM を示す、000000 の既定値は、active_start_timeis int, with a default of 000000, which indicates 12:00:00 A.M. を 24 時間形式で表したものです。HHMMSS 形式で入力する必要があります。on a 24-hour clock, and must be entered using the form HHMMSS.

[ @active_end_time = ] active_end_time 間の日で時間active_start_dateactive_end_dateジョブの実行を終了します。[ @active_end_time = ] active_end_time The time on any day between active_start_date and active_end_date to end execution of a job. active_end_timeint、既定値は235959、午後 11時 59分: 59 を示しますactive_end_timeis int, with a default of 235959, which indicates 11:59:59 P.M. を 24 時間形式で表したものです。HHMMSS 形式で入力する必要があります。on a 24-hour clock, and must be entered using the form HHMMSS.

[ @owner_login_name = ] 'owner_login_name'] スケジュールを所有するサーバー プリンシパルの名前。[ @owner_login_name = ] 'owner_login_name'] The name of the server principal that owns the schedule. owner_login_namesysnameで、既定値は NULL には、スケジュールが作成者によって所有されていることを示します。owner_login_name is sysname, with a default of NULL, which indicates that the schedule is owned by the creator.

[ @automatic_post = ] automatic_post 予約されています。[ @automatic_post = ] automatic_post Reserved.

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

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

コメントRemarks

スケジュールをすぐに使用するすべてのジョブは、新しい設定を使用します。All jobs that use the schedule immediately use the new settings. ただし、スケジュールを変更しても、現在実行されているジョブは停止しません。However, changing a schedule does not stop jobs that are currently running.

アクセス許可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.

メンバーだけsysadmin別のユーザーが所有するスケジュールを変更できます。Only members of sysadmin can modify a schedule owned by another user.

使用例Examples

次の例の有効な状態の変更、NightlyJobsスケジュール0、所有者を設定およびterridThe following example changes the enabled status of the NightlyJobs schedule to 0 and sets the owner to terrid.

USE msdb ;  
GO  
  
EXEC dbo.sp_update_schedule  
    @name = 'NightlyJobs',  
    @enabled = 0,  
    @owner_login_name = 'terrid' ;  
GO  

関連項目See Also

作成し、スケジュールをジョブにアタッチ Create and Attach Schedules to Jobs
ジョブのスケジュール Schedule a Job
スケジュールを作成します。 Create a Schedule
SQL Server エージェント ストアド プロシージャ(TRANSACT-SQL) SQL Server Agent Stored Procedures (Transact-SQL)
sp_add_schedule (TRANSACT-SQL) sp_add_schedule (Transact-SQL)
sp_add_jobschedule (TRANSACT-SQL) sp_add_jobschedule (Transact-SQL)
sp_delete_schedule (TRANSACT-SQL) sp_delete_schedule (Transact-SQL)
sp_help_schedule (TRANSACT-SQL) sp_help_schedule (Transact-SQL)
sp_attach_schedule (Transact-SQL)sp_attach_schedule (Transact-SQL)