sp_detach_schedule (Transact-SQL)

語法

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

引數

• [@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，但不能同時指定這兩者。

• [@delete_unused_schedule= ] delete_unused_schedule
  指定是否要刪除未使用的作業排程。delete_unused_schedule 是 bit，預設值是 0，表示保留所有排程，即使沒有作業參考它們也是如此。如果設為 1，且沒有作業在參考未用的作業排程，便刪除這些排程。

傳回碼值

0 (成功) 或 1 (失敗)

結果集

無

權限

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

• SQLAgentUserRole

• SQLAgentReaderRole

• SQLAgentOperatorRole

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

SQL Server 會檢查以判斷使用者是否擁有這份排程。只有系統管理員 (sysadmin) 固定伺服器角色的成員可以從另一位使用者所擁有的作業中卸離排程。

範例

下列範例會移除 'NightlyJobs' 排程和 'BackupDatabase' 作業之間的關聯。

USE msdb ;
GO

EXEC dbo.sp_detach_schedule
    @job_name = 'BackupDatabase',
    @schedule_name = 'NightlyJobs' ;
GO

請參閱

參考