sp_add_jobschedule (Transact-SQL)

適用対象: SQL ServerAzure SQL Managed Instance

SQL Server エージェント ジョブのスケジュールを作成します。

Transact-SQL 構文表記規則

重要

現在、Azure SQL Managed Instance によって、すべてではありませんが、ほとんどの SQL Server エージェントの機能がサポートされています。 詳細については、Azure SQL Managed Instance と SQL Server の T-SQL の相違点に関するページを参照してください。

構文

sp_add_jobschedule
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    , [ @name = ] N'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 ]
    [ , [ @schedule_id = ] schedule_id OUTPUT ]
    [ , [ @automatic_post = ] automatic_post ]
    [ , [ @schedule_uid = ] 'schedule_uid' OUTPUT ]
[ ; ]

引数

[ @job_id = ] 'job_id'

スケジュールを追加するジョブの識別番号を指定します。 @job_idは uniqueidentifier で、既定値は NULL.

@job_idまたは@job_nameを指定する必要がありますが、両方を指定することはできません。

[ @job_name = ] N'job_name'

スケジュールが追加されるジョブの名前。 @job_nameは sysname で、既定値は NULL.

@job_idまたは@job_nameを指定する必要がありますが、両方を指定することはできません。

[ @name = ] N'name'

スケジュールの名前。 @nameは sysname で、既定値はありません。

[ @enabled = ] が有効

スケジュールの現在の状態を示します。 @enabledは tinyint で、既定値は 1 (有効) です。 場合 0、スケジュールが有効になっていません。 スケジュールが無効になっている場合、ジョブは実行されません。

[ @freq_type = ] freq_type

いつジョブを実行するかを示す値を指定します。 @freq_typeは int であり、次のいずれかの値を指定できます。

Value	説明
1	1 回。
4	毎日
8	週単位
16	月単位
32	月単位(@freq_intervalに対する相対値)。
64	SQL Server エージェント サービスの起動時に実行します。
128	コンピューターがアイドル状態のときに実行します。

[ @freq_interval = ] freq_interval

ジョブを実行する日を指定します。 @freq_intervalは int で、既定値は 、次の0表に示すように@freq_typeの値によって異なります。

@freq_typeの 値	@freq_intervalへの 影響
1 (1 回)	@freq_intervalは使用されません。
4 (毎日)	@freq_interval日ごと。
8 (毎週)	@freq_intervalは、次の 1 つ以上 (論理演算子と組み合わせたものOR) です。 1 = 日曜日 2 = 月曜日 4 = 火曜日 8 = 水曜日 16 = 木曜日 32 = 金曜日 64 = 土曜日
16 (月単位)	月の @freq_interval 日。
32 (月単位の相対)	@freq_intervalは次のいずれかです。 1 = 日曜日 2 = 月曜日 3 = 火曜日 4 = 水曜日 5 = 木曜日 6 = 金曜日 7 = 土曜日 8 = 日 9 = 平日 10 = 週末
64(SQL Server エージェント サービスの起動時)	@freq_intervalは使用されません。
128	@freq_intervalは使用されません。

[ @freq_subday_type = ] freq_subday_type

@freq_subday_intervalの単位を指定します。 @freq_subday_typeは int であり、次のいずれかの値を指定できます。

Value	説明 (単位)
0x1	指定した時刻
0x2	秒
0x4	分
0x8	時間

[ @freq_subday_interval = ] freq_subday_interval

ジョブの 各実行間に発生する@freq_subday_type 期間の数。 @freq_subday_intervalは int で、既定値は 0.

[ @freq_relative_interval = ] freq_relative_interval

さらに、@freq_typeが (毎月の相対) に設定されている場合の@freq_intervalを32定義します。

@freq_relative_intervalは int であり、次のいずれかの値を指定できます。

Value	説明 (単位)
1	First
2	Second
4	Third
8	4 番目
16	末尾

@freq_relative_intervalは、間隔の発生を示します。 たとえば、@freq_relative_intervalが 、@freq_typeに設定232され、@freq_intervalが設定3されている場合、スケジュールされたジョブは毎月第 2 火曜日に実行されます。

[ @freq_recurrence_factor = ] freq_recurrence_factor

ジョブのスケジュールされた実行の間の週または月数。 @freq_recurrence_factorは int で、既定値は 0. @freq_recurrence_factorは、@freq_typeが 、16または 32> に8設定されている場合にのみ使用されます。

[ @active_start_date = ] active_start_date

ジョブの実行を開始できる日付。 @active_start_dateは int で、既定値は NULL. 日付は次のように yyyyMMdd書式設定されます。 @active_start_dateが設定されている場合、日付は次の値以上19900101である必要があります。

スケジュールが作成されたら、開始日を確認し、正しい日付であることを確認します。 詳細については、「スケジュールを作成してジョブにアタッチする」の「開始日のスケジュール設定」セクションを参照してください。

[ @active_end_date = ] active_end_date

ジョブの実行を停止できる日付。 @active_end_dateは int で、既定値は 99991231. 日付は次のように yyyyMMdd書式設定されます。

[ @active_start_time = ] active_start_time

ジョブの実行を開始する@active_start_dateから@active_end_dateまでの任意の日の時刻。 @active_start_timeは int で、既定値は 000000. 時刻は 24 時間制で HHmmss 書式設定されます。

[ @active_end_time = ] active_end_time

ジョブの実行を終了するactive_start_dateから@active_end_dateまでの任意の日の時刻。 @active_end_timeは int で、既定値は 235959. 時刻は 24 時間制で HHmmss 書式設定されます。

[ @schedule_id = ] schedule_id OUTPUT

スケジュールが正常に作成された場合は、スケジュールに割り当てられた ID 番号をスケジュールします。 @schedule_idは int 型の OUTPUT パラメーターです。

[ @automatic_post = ] automatic_post

単に情報を示すためだけに特定されます。 サポートされていません。 将来の互換性は保証されません。

[ @schedule_uid = ] 'schedule_uid' OUTPUT

スケジュールの一意識別子を指定します。 @schedule_uidは uniqueidentifier 型の OUTPUT パラメーターです。

リターン コードの値

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

結果セット

ありません。

解説

ジョブ スケジュールをジョブとは別に管理できるようになりました。 ジョブにスケジュールを追加するには、スケジュールの作成とsp_attach_scheduleジョブへのスケジュールのアタッチに使用sp_add_scheduleします。

アクセス許可

このストアド プロシージャは、db_owner ロールによって所有されています。 任意のユーザーにアクセス許可を付与 EXECUTE できますが、SQL Server のアップグレード中にこれらのアクセス許可がオーバーライドされる可能性があります。

他のユーザーには、データベース内の固定データベース ロールSQL Server エージェント次のいずれかを付与するmsdb必要があります。

• SQLAgentUserRole
• SQLAgentReaderRole
• SQLAgentOperatorRole

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

例

次の例では、毎週土曜日の午前 2 時に SaturdayReports実行されるジョブ スケジュールを割り当てます。

EXEC msdb.dbo.sp_add_jobschedule
    @job_name = N'SaturdayReports', -- Job name
    @name = N'Weekly_Sat_2AM', -- Schedule name
    @freq_type = 8, -- Weekly
    @freq_interval = 64, -- Saturday
    @freq_recurrence_factor = 1, -- every week
    @active_start_time = 20000 -- 2:00 AM

関連するコンテンツ

• スケジュールの作成とジョブへのアタッチ
• ジョブのスケジュール設定
• Create a Schedule
• SQL Server エージェント ストアド プロシージャ (Transact-SQL)
• sp_add_schedule (Transact-SQL)
• sp_update_schedule (Transact-SQL)
• sp_delete_schedule (Transact-SQL)
• sp_help_schedule (Transact-SQL)
• sp_attach_schedule (Transact-SQL)