sp_detach_schedule (Transact-SQL)

  • 项目

适用于：SQL Server

删除计划和作业之间的关联。

Transact-SQL 语法约定

语法

sp_detach_schedule
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @schedule_id = ] schedule_id ]
    [ , [ @schedule_name = ] N'schedule_name' ]
    [ , [ @delete_unused_schedule = ] delete_unused_schedule ]
    [ , [ @automatic_post = ] automatic_post ]
[ ; ]

参数

[ @job_id = ] 'job_id'

要从中删除计划的作业的标识号。 @job_id是 uniqueidentifier，默认值为 NULL.

[ @job_name = ] N'job_name'

要从中删除计划的作业的名称。 @job_name为 sysname，默认值为 NULL.

注意

必须指定@job_id或@job_name，但不能指定这两者。

[ @schedule_id = ] schedule_id

要从作业中删除的计划的标识号。 @schedule_id为 int，默认值为 NULL.

[ @schedule_name = ] N'schedule_name'

要从作业中删除的计划的名称。 @schedule_name为 sysname，默认值为 NULL.

注意

必须指定@schedule_id或@schedule_name，但不能指定两者。

[ @delete_unused_schedule = ] delete_unused_schedule

指定是否删除未使用的作业计划。 @delete_unused_schedule为位，默认值为 0.

  • 如果设置为 0，则保留所有计划，即使没有作业引用它们。
  • 如果设置为 1，则如果未引用任何作业，则删除未使用的作业计划。

[ @automatic_post = ] automatic_post

标识为仅供参考。 不支持。 不保证以后的兼容性。

返回代码值

0（成功）或 1（失败）。

结果集

无

权限

此存储过程由 db_owner 角色拥有。 你可以为任何用户授予 EXECUTE 权限，但这些权限可能会在 SQL Server 升级期间被重写。

其他用户必须被授予数据库中以下SQL Server 代理固定数据库角色msdb之一：

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

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

作业所有者可以将作业附加到计划，并从计划中分离作业，而无需成为计划所有者。 但是，如果分离将不带任何作业，则无法删除计划，除非调用方是计划所有者。

只有 sysadmin 的成员才能使用此存储过程编辑其他用户拥有的作业的属性。

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

示例

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

USE msdb;
GO

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

相关内容