更改指定作業(yè)的調(diào)度設(shè)置。
sp_update_jobschedule [@job_id =] job_id, | [@job_name =] 'job_name',
[@name =] '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]
[@job_id =] job_id
是調(diào)度所屬于的作業(yè)的標(biāo)識(shí)號(hào)。job_id 的數(shù)據(jù)類型為 uniqueidentifier,其默認(rèn)值為 NULL。
[@job_name =] 'job_name'
是調(diào)度所屬于的作業(yè)的名稱。各作業(yè)名稱都必須是唯一的。job_name 的數(shù)據(jù)類型為 sysname,其默認(rèn)值為 NULL。
說(shuō)明 必須或者指定 job_id 或者指定 job_name,但不能兩個(gè)都指定。
[@name =] 'name'
是要修改的調(diào)度的名稱。name 的數(shù)據(jù)類型為 sysname,無(wú)默認(rèn)值。
[@new_name =] 'new_name'
是調(diào)度的新名稱。new_name 的數(shù)據(jù)類型為 sysname,其默認(rèn)值為 NULL。
[@enabled =] enabled
指定啟用 (1) 或不啟用 (0) 調(diào)度。enabled 的數(shù)據(jù)類型為 tinyint,其默認(rèn)值為 NULL。
[@freq_type =] freq_type
指定該作業(yè)運(yùn)行的頻繁程度。freq_type 的數(shù)據(jù)類型為 int,其默認(rèn)值為 NULL,且可以取下列值之一。
值 | 描述 |
---|---|
1 | 一次。 |
4 | 按天。 |
8 | 按星期。 |
16 | 按月。 |
32 | 按月,相對(duì)于 freq_interval。 |
64 | 當(dāng) SQL Server代理啟動(dòng)時(shí)運(yùn)行。 |
128 | 當(dāng)計(jì)算機(jī)空閑時(shí)運(yùn)行。 |
[@freq_interval =] freq_interval
指定作業(yè)在哪一天運(yùn)行。freq_interval 的數(shù)據(jù)類型為 int,其默認(rèn)值為 NULL。freq_interval 的值取決于 freq_type 的值。
freq_type 的值 | 對(duì) freq_interval 的影響 |
---|---|
1(一次) | 未使用 freq_interval。 |
4(每天) | 每個(gè) freq_interval 日。 |
8(每周) | freq_interval 是下列某個(gè)值或多個(gè)值(或 (OR) 在一起): 1 = 星期日 |
16(每月) | 每月的 freq_interval 日。 |
32(每月相對(duì)信息) | freq_interval 可以取下列值之一: 1 = 星期日 |
64(SQL Server 代理程序啟動(dòng)時(shí)) | 未使用 freq_interval。 |
[@freq_subday_type =] freq_subday_type
指定 freq_subday_interval 的單位。freq_subday_type 的數(shù)據(jù)類型為 int,其默認(rèn)值為 NULL,且可以取下列值之一。
值 | 描述(單位) |
---|---|
0x1 | 在指定的時(shí)間。 |
0x4 | 分鐘。 |
0x8 | 小時(shí)。 |
[@freq_subday_interval =] freq_subday_interval
指定作業(yè)每次執(zhí)行之間的周期數(shù),周期以 freq_subday_type 為單位。freq_subday_interval 的數(shù)據(jù)類型為 int,其默認(rèn)值為 NULL。
[@freq_relative_interval =] freq_relative_interval
當(dāng) freq_interval 的值為 32(每月相對(duì)信息)時(shí),指定每月調(diào)度作業(yè)發(fā)生的 freq_interval。freq_relative_interval 的數(shù)據(jù)類型為 int,其默認(rèn)值為 NULL,且可以取下列值之一。
值 | 描述(單位) |
---|---|
1 | 第一個(gè) |
2 | 第二個(gè) |
4 | 第三個(gè) |
8 | 第四個(gè) |
16 | 最后一個(gè) |
[@freq_recurrence_factor =] freq_recurrence_factor
指定作業(yè)各次調(diào)度執(zhí)行之間的月數(shù)。freq_recurrence_factor 僅當(dāng) freq_type 為 8、16 或 32 時(shí)才使用。freq_recurrence_factor 的數(shù)據(jù)類型為 int,其默認(rèn)值為 NULL。
[@active_start_date =] active_start_date
是作業(yè)可以開始執(zhí)行的日期。active_start_date 的數(shù)據(jù)類型為 int,其默認(rèn)值為 NULL。其值必須為 YYYYMMDD 格式。如果 active_start_date 不為 NULL,則日期必須大于或等于 19900101。
[@active_end_date =] active_end_date
是作業(yè)可以停止執(zhí)行的日期。active_end_date 的數(shù)據(jù)類型為 int,其默認(rèn)值為 NULL。其值必須為 YYYYMMDD 格式。
[@active_start_time =] active_start_time
是在 active_start_date 與 active_end_date 之間任何一天作業(yè)開始執(zhí)行的時(shí)間。active_start_time 的數(shù)據(jù)類型為 int,其默認(rèn)值為 NULL。其值必須以 HHMMSS 的格式輸入。
[@active_end_time =] active_end_time
是在 active_start_date 與 active_end_date 之間任何一天作業(yè)停止執(zhí)行的時(shí)間。active_end_time 的數(shù)據(jù)類型為 int,其默認(rèn)值為 NULL。其值必須以 HHMMSS 的格式輸入。
0(成功)或 1(失?。?/P>
sp_update_jobschedule 必須從 msdb 數(shù)據(jù)庫(kù)中運(yùn)行。
更新作業(yè)調(diào)度將增加作業(yè)的版本號(hào)。
執(zhí)行權(quán)限默認(rèn)授予 public 角色。
下例禁用 Archive Tables 作業(yè)的 Monday Archive 調(diào)度,并更改該調(diào)度的名稱。
USE msdb
EXEC sp_update_jobschedule @job_name = 'Archive Tables',
@name = 'Monday Archive',
@new_name = 'Monday Archive - DEACTIVATED',
@enabled = 0
相關(guān)文章