Share via


sp_attach_schedule (Transact-SQL)

設定作業的排程。

主題連結圖示Transact-SQL 語法慣例

語法

sp_attach_schedule
     { [ @job_id = ] job_id | [ @job_name = ] 'job_name' } , 
     { [ @schedule_id = ] schedule_id 
     | [ @schedule_name = ] 'schedule_name' }

引數

  • [@job_id= ] job_id
    這是要加入排程之作業的作業識別碼。job_id是 uniqueidentifier,預設值是 NULL。

  • [@job_name = ] 'job_name'
    這是要加入排程的作業名稱。job_name 是 sysname,預設值是 NULL。

    [!附註]

    您必須指定 job_id 或 job_name,但不能同時指定這兩者。

  • [@schedule_id = ] schedule_id
    這是作業所要設定之排程的排程識別碼。schedule_id 是 int,預設值是 NULL

  • [@schedule_name = ] 'schedule_name'
    這是要對作業設定的排程名稱。schedule_name 是 sysname,預設值是 NULL。

    [!附註]

    您必須指定 schedule_id 或 schedule_name,但不能同時指定這兩者。

備註

排程和作業的擁有者必須相同。

多項作業可以設定同一份排程。一項作業可以根據多份排程來執行。

這個預存程序必須從 msdb 資料庫中執行。

權限

依預設,只有系統管理員 (sysadmin) 固定伺服器角色的成員,才能夠執行這個預存程序。其他使用者必須被授與 msdb 資料庫的下列其中一個 SQL Server Agent 固定資料庫角色。

  • SQLAgentUserRole

  • SQLAgentReaderRole

  • SQLAgentOperatorRole

如需有關這些角色權限的詳細資料,請參閱<SQL Server Agent 固定資料庫角色>。

SQL Server 會檢查使用者是否同時擁有作業和排程。

範例

下列範例會建立一份名稱為 NightlyJobs 的排程。每天伺服器時間到了 01:00 時,就會開始執行使用這份排程的作業。這個範例會將排程附加至 BackupDatabase 作業和 RunReports 作業上。

[!附註]

這個範例假設 BackupDatabase 作業和 RunReports 作業都已經存在。

USE msdb ;
GO

EXEC sp_add_schedule
    @schedule_name = N'NightlyJobs' ,
    @freq_type = 4,
    @freq_interval = 1,
    @active_start_time = 010000 ;
GO


EXEC sp_attach_schedule
   @job_name = N'BackupDatabase',
   @schedule_name = N'NightlyJobs' ;
GO

EXEC sp_attach_schedule
   @job_name = N'RunReports',
   @schedule_name = N'NightlyJobs' ;
GO