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 代理固定数据库角色的权限之一:
- SQLAgentUserRole
- SQLAgentReaderRole
- SQLAgentOperatorRole
有关这些角色的权限的详细信息,请参阅 SQL Server 代理固定数据库角色。
Microsoft 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)