創(chuàng)建作業(yè)調(diào)度。
sp_add_jobschedule [ @job_id = ] job_id, | [ @job_name = ] 'job_name',
[ @name = ] '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 ]
[ @jobid = ] job_id
將向其中添加調(diào)度的作業(yè)的作業(yè)標識號。job_id 的數(shù)據(jù)類型為 uniqueidentifier,默認設(shè)置為 NULL。
[ @job_name = ] 'job_name'
作業(yè)的名稱,調(diào)度即添加到該作業(yè)中。job_name 的數(shù)據(jù)類型為 sysname,默認設(shè)置為 NULL。
說明 必須指定 job_id 或 job_name,但不能兩個都指定。
[ @name = ] 'name'
調(diào)度的名稱。name 的數(shù)據(jù)類型為 sysname,沒有默認設(shè)置。
[ @enabled = ] enabled
指明調(diào)度的當前狀態(tài)。enabled 的數(shù)據(jù)類型為 tinyint,默認設(shè)置為 1(啟用)。如果為 0,則不啟用調(diào)度。禁用該調(diào)度時,不運行作業(yè)。
[ @freq_type = ] freq_type
用于指明何時將執(zhí)行作業(yè)的值。freq_type 的數(shù)據(jù)類型為 int,默認設(shè)置為 0,可以是下列值之一。
值 | 描述 |
---|---|
1 | 一次 |
4 | 每天 |
8 | 每周 |
16 | 每月 |
32 | 每月,與 freq interval 相關(guān) |
64 | 當 SQLServerAgent 服務(wù)啟動時運行 |
128 | 計算機空閑時運行 |
[ @freq_interval = ] freq_interval
作業(yè)執(zhí)行的天數(shù)。freq_interval 的數(shù)據(jù)類型為 int,默認設(shè)置為 0,依賴于 freq_type 的值。
freq_type 的值 | 對 freq_interval 的影響 |
---|---|
1(一次) | 未使用 freq_interval。 |
4(每天) | 每個 freq_interval 日。 |
8(每周) | freq_interval 為下面的一個或多個值(與 OR 邏輯運算符結(jié)合使用): 1 = 星期日 |
16(每月) | 每月的 freq_interval 日。 |
32(每月相對) | freq_interval 為下列值之一: 1 = 星期日 |
64(當 SQLServerAgent 服務(wù)啟動時) | 未使用 freq_interval。 |
128 | 未使用 freq_interval。 |
[ @freq_subday_type = ] freq_subday_type
指定 freq_subday_interval 的單位。freq_subday_type 為 int 類型,其默認值為 0,且可以取下列值之一。
值 | 描述(單位) |
---|---|
0x1 | 在指定的時間 |
0x4 | 分鐘 |
0x8 | 小時 |
[ @freq_subday_interval = ] freq_subday_interval
作業(yè)每次執(zhí)行之間要出現(xiàn)的 freq_subday_type 周期數(shù)。freq_subday_interval 的數(shù)據(jù)類型為 int,默認設(shè)置為 0。
[ @freq_relative_interval = ] freq_relative_interval
如果 freq_interval 是 32(每月相對),則為每月中已調(diào)度作業(yè)的 freq_interval 的發(fā)生情況。freq_relative_interval 的數(shù)據(jù)類型為 int,默認設(shè)置為 0,可以是下列值之一。
值 | 描述(單位) |
---|---|
1 | 第一頁 |
2 | 秒 |
4 | 第三個 |
8 | 第四個 |
16 | 最后一頁 |
[ @freq_recurrence_factor = ] freq_recurrence_factor
作業(yè)的已調(diào)度執(zhí)行之間的周數(shù)或月數(shù)。只有當 freq_type 是 8、16 或 32 時,才使用 freq_recurrence_factor。freq_recurrence_factor 的數(shù)據(jù)類型為 int,默認設(shè)置為 0。
[ @active_start_date = ] active_start_date
作業(yè)可開始執(zhí)行的日期。active_start_date 的數(shù)據(jù)類型為 int,默認設(shè)置為 NULL,該值表示當天的日期。日期的格式為 YYYYMMDD。如果 active_start_date 不為 NULL,則日期必須大于或等于 19900101。
[ @active_end_date = ] active_end_date
作業(yè)可停止執(zhí)行的日期。active_end_date 的數(shù)據(jù)類型為 int,默認設(shè)置為 99991231,該值表示 9999 年 12 月 31 日。格式為 YYYYMMDD。
[ @active_start_time = ] active_start_time
在 active_start_date 和 active_end_date 之間的任何一天開始執(zhí)行作業(yè)的時間。active_start_time 的數(shù)據(jù)類型為 int,默認設(shè)置為 000000,該值表示 24 小時制的上午 12:00:00,并且必須使用格式 HHMMSS 進行輸入。
[ @active_end_time = ] active_end_time
在 active_start_date 和 active_end_date 之間的任何一天停止執(zhí)行作業(yè)的時間。active_end_time 的數(shù)據(jù)類型為 int,默認設(shè)置為 235959,該值表示 24 小時制的下午 11:59:59,并且必須使用格式 HHMMSS 進行輸入。
0(成功)或 1(失?。?/P>
無
SQL Server 企業(yè)管理器提供易于使用的圖形方法來管理作業(yè),建議使用該方法創(chuàng)建和管理作業(yè)基本結(jié)構(gòu)。
執(zhí)行權(quán)限默認授予 public 角色。
此示例假設(shè)已經(jīng)創(chuàng)建用來備份數(shù)據(jù)庫的 NightlyBackup 作業(yè)。它將作業(yè)添加到名為 ScheduledBackup 的調(diào)度中,并且在每天上午 1:00 執(zhí)行。
USE msdb
EXEC sp_add_jobschedule @job_name = 'NightlyBackup',
@name = 'ScheduledBackup',
@freq_type = 4, -- daily
@freq_interval = 1,
@active_start_time = 10000
相關(guān)文章