通过

  • 项目

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 代理固定数据库角色的权限之一：

  • SQLAgentUserRole

  • SQLAgentReaderRole

  • SQLAgentOperatorRole

有关这些角色的权限的详细信息，请参阅 SQL Server 代理固定数据库角色。

SQL Server 将进行检查以确定用户是否拥有计划。只有 sysadmin 固定服务器角色的成员才能将计划与其他用户所有的作业分离。

示例

以下示例将删除 'NightlyJobs' 计划和 'BackupDatabase' 作业之间的关联。

USE msdb ;
GO

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