sp_update_schedule (Transact-SQL)
變更 SQL Server Agent 排程的設定。
.gif "主題連結圖示")
語法
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 ]
引數
[ @schedule_id = ] schedule_id
這是要修改的排程識別碼。 schedule_id 是 int，沒有預設值。 您必須指定 schedule_id 或 schedule_name 其中之一。[ @name = ] 'schedule_name'
這是要修改的排程名稱。 schedule_name 是 sysname，沒有預設值。 您必須指定 schedule_id 或 schedule_name 其中之一。[ @new_name= ] new_name
排程的新名稱。 new_name 是 sysname，預設值是 NULL。 當 new_name 是 NULL 時，排程的名稱會維持不變。[ @enabled = ] enabled
指出排程的目前狀態。 enabled 是 tinyint，預設值是 1 (已啟用)。 如果是 0，就表示未啟用排程。 當未啟用排程時，不會依據這份排程來執行任何作業。[ @freq_type = ] freq_type
指出將執行作業之時間的值。 freq_type是 int，預設值為 0，而且可以是下列其中一個值。值
說明
1
一次
4
每日
8
每週
16
每月
32
每月，相對於 freq interval
64
在 SQLServerAgent 服務啟動之時執行
128
在電腦閒置之時執行
[ @freq_interval = ] freq_interval
執行作業的天數。 freq_interval 是 int，預設值是 0；它會隨著 freq_type 的值而不同。freq_type 的值
freq_interval 的作用
1 (一次)
freq_interval 未使用。
4 (每天)
每隔 freq_interval 天。
8 (每週)
freq_interval 是下列一或多項 (以 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 (當 SQLServerAgent 服務啟動時)
freq_interval 未使用。
128
freq_interval 未使用。
[ @freq_subday_type = ] freq_subday_type
指定 freq_subday_interval 的單位。freq_subday_type 是 int，預設值是 0，而且可以是下列其中一個值。值
描述 (單位)
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_interval 是 32 (每月相對)，便會在每月的 freq_interval 發生作業。 freq_relative_interval是 int，預設值為 0，而且可以是下列其中一個值。值
描述 (單位)
1
第一個
2
第二個
4
第三個
8
第四個
16
最後一個
[ @freq_recurrence_factor = ] freq_recurrence_factor
作業的各排程執行之間的週數或月數。 如果 freq_type 是 8、16 或 32，則使用 freq_recurrence_factor。 freq_recurrence_factor是 int，預設值是 0。[ @active_start_date = ] active_start_date
可以開始執行作業的日期。 active_start_date是 int，預設值是 NULL，表示今天的日期。 日期格式為 YYYYMMDD。 如果 active_start_date 不是 NULL，這個日期就必須大於或等於 19900101。建立排程之後，檢閱開始日期，並確認該日期正確。 如需詳細資訊，請參閱＜建立及附加排程至作業＞中的「排程開始日期」一節。
[ @active_end_date = ] active_end_date
可以停止執行作業的日期。 active_end_date是 int，預設值是 99991231，表示 9999 年 12 月 31 日。 格式為 YYYYMMDD。[ @active_start_time = ] active_start_time
在 active_start_date 和 active_end_date 之間的任何一天，開始執行作業的時間。 active_start_time是 int，預設值是 000000，表示 24 小時制的上午 12:00:00， 必須用 HHMMSS 格式來輸入。[ @active_end_time = ] active_end_time
在 active_start_date 和 active_end_date 之間的任何一天，結束執行作業的時間。 active_end_time是 int，預設值是 235959，表示 24 小時制的下午 11:59:59， 必須用 HHMMSS 格式來輸入。[ @owner_login_name= ] 'owner_login_name']
擁有排程之伺服器主體的名稱。 owner_login_name 是 sysname，預設值是 NULL，表示排程是建立者所擁有。[ @automatic_post =] automatic_post
已保留。
傳回碼值
0 (成功) 或 1 (失敗)
備註
所有使用排程的作業都會立即使用新設定。 不過，變更排程並不會停止目前在執行中的作業。
權限
依預設，只有系統管理員 (sysadmin) 固定伺服器角色的成員，才能夠執行這個預存程序。 其他使用者必須被授與 msdb 資料庫的下列其中一個 SQL Server Agent 固定資料庫角色。
SQLAgentUserRole
SQLAgentReaderRole
SQLAgentOperatorRole
如需有關這些角色權限的詳細資料，請參閱＜SQL Server Agent 固定資料庫角色＞。
只有系統管理員 (sysadmin) 的成員可以修改另一位使用者所擁有的排程。
範例
下列範例會將 NightlyJobs 排程的啟用狀態改成 0，並將擁有者設為 terrid。
USE msdb ;
GO
EXEC dbo.sp_update_schedule
@name = 'NightlyJobs',
@enabled = 0,
@owner_login_name = 'terrid' ;
GO
請參閱
參考
SQL Server Agent 預存程序 (Transact-SQL)
sp_add_schedule (Transact-SQL)
sp_add_jobschedule (Transact-SQL)
sp_delete_schedule (Transact-SQL)
sp_help_schedule (Transact-SQL)
sp_attach_schedule (Transact-SQL)