共用方式為

sp_detach_schedule (Transact-SQL)

  • 發行項

移除排程和作業之間的關聯。

主題連結圖示 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

請參閱

參考

sp_add_schedule (Transact-SQL)

sp_attach_schedule (Transact-SQL)

sp_delete_schedule (Transact-SQL)