sp_delete_job (Transact-SQL)

删除作业。

语法

sp_delete_job { [ @job_id = ] job_id | [ @job_name = ] 'job_name' } ,
     [ , [ @originating_server = ] 'server' ] 
     [ , [ @delete_history = ] delete_history ]
     [ , [ @delete_unused_schedule = ] delete_unused_schedule ]

参数

  • [ @job_id= ] job_id
    要删除的作业的标识号。job_id的数据类型为 uniqueidentifier,默认值为 NULL。
  • [ @job_name= ] 'job_name'
    要删除的作业的名称。job_name 的数据类型为 sysname,默认值为 NULL。

    ms188376.note(zh-cn,SQL.90).gif注意:
    必须指定 job_idjob_name;但不能两个都指定。
  • [ @originating_server= ] 'server'
    供内部使用。
  • [ @delete_history= ] delete_history
    指定是否删除作业的历史记录。delete_history 的数据类型为 bit,默认值为 1。当 delete_history1 时,将删除作业的历史记录。当 delete_history0 时,将不删除作业的历史记录。

    请注意,如果删除了作业但未删除作业历史记录,则该作业的历史信息将不显示在 SQL Server 代理图形用户界面作业历史记录中,此类信息将仍然驻留在 msdb 数据库的 sysjobhistory 表中。

  • [ @delete_unused_schedule= ] delete_unused_schedule
    指定是否删除附加到该作业的计划(如果这些计划没有附加到任何其他作业)。delete_unused_schedule 的数据类型为 bit,默认值为 1。当 delete_unused_schedule1 时,如果其他任何作业均未引用附加到该作业的计划,则会删除这些计划。当 delete_unused_schedule0 时,将不删除计划。

返回代码值

0(成功)或 1(失败)

结果集

备注

保留 @originating_server 参数供内部使用。

@delete_unused_schedule 参数通过自动删除未附加到任何作业的计划来提供与早期版本的 SQL Server 的向后兼容性。请注意,此参数默认为向后兼容行为。要保留未附加到作业的计划,必须为 @delete_unused_schedule 参数提供值 0

SQL Server Management Studio 为管理作业提供了一种图形化的简便方法,建议使用此方法来创建和管理作业基础结构。

此存储过程不能删除维护计划,也不能删除维护计划中包含的作业。请改用 SQL Server Management Studio 来删除维护计划。

权限

默认情况下,只有 sysadmin 固定服务器角色的成员才可以执行此存储过程。其他用户必须被授予 msdb 数据库中下列 SQL Server 代理固定数据库角色的权限之一:

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

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

sysadmin 固定服务器角色成员可以执行 sp_delete_job 删除任何作业。非 sysadmin 固定服务器角色成员的用户只能删除该用户所拥有的作业。

示例

以下示例删除作业 NightlyBackups

USE msdb ;
GO

EXEC sp_delete_job
    @job_name = N'NightlyBackups' ;
GO

请参阅

参考

sp_add_job (Transact-SQL)
sp_help_job (Transact-SQL)
sp_update_job (Transact-SQL)
系统存储过程 (Transact-SQL)

帮助和信息

获取 SQL Server 2005 帮助