sp_help_jobs_in_schedule (Transact-SQL)

返回有关附加了特定计划的作业的信息。

Transact-SQL 语法约定

语法

sp_help_jobs_in_schedule 
     [ @schedule_name = ] 'schedule_name' ,
     [ @schedule_id = ] schedule_id 

参数

• [ @schedule_id = ] schedule_id
  将列出其信息的计划的标识符。schedule_id 的数据类型为 int，无默认值。可以指定 schedule_id 或 schedule_name。

• [ @schedule_name = ] 'schedule_name'
  将列出其信息的计划的名称。schedule_name 的数据类型为 sysname，无默认值。可以指定 schedule_id 或 schedule_name。

返回代码值

0（成功）或 1（失败）

结果集

返回以下结果集：

列名	数据类型	说明
job_id	uniqueidentifier	作业的唯一 ID。
originating_server	nvarchar(30)	作业来自的服务器的名称。
name	sysname	作业的名称。
enabled	tinyint	指示是否启用待执行的作业。
description	nvarchar(512)	对作业的说明。
start_step_id	int	执行作业的起始步骤的 ID。
category	sysname	作业类别。
owner	sysname	作业所有者。
notify_level_eventlog	int	位掩码，它表示在何种情况下通知事件应记录到 Microsoft Windows 应用程序日志中。可以是下列值之一： 0 = 从不 1 = 当作业成功时 2 = 当作业失败时 3 = 当作业完成时（不考虑作业结果）
notify_level_email	int	位掩码，它指示当作业完成时，在什么情况下应该发送一个通知电子邮件。可能值与 notify_level_eventlog 的可能值相同。
notify_level_netsend	int	位掩码，它表示当作业完成时，在什么情况下应该发送一个网络消息。可能值与 notify_level_eventlog 的可能值相同。
notify_level_page	int	位掩码，它表示当作业完成时，在什么情况下应该发送一个呼叫。可能值与 notify_level_eventlog 的可能值相同。
notify_email_operator	sysname	要通知的操作员的电子邮件名称。
notify_netsend_operator	sysname	在发送网络消息时所使用的计算机或用户的名称。
notify_page_operator	sysname	在发送寻呼时所使用的计算机或用户的名称。
delete_level	int	位掩码，它表示当作业完成时，在什么情况下应该删除作业。可能值与 notify_level_eventlog 的可能值相同。
date_created	datetime	作业的创建日期。
date_modified	datetime	上次修改作业的日期。
version_number	int	作业的版本（每次修改作业时都自动对其进行更新）。
last_run_date	int	作业上一次开始执行的日期。
last_run_time	int	作业上一次开始执行的时间。
last_run_outcome	int	作业上一次运行时所得到的结果： 0 = 失败 1 = 成功 3 = 已取消 5 = 未知
next_run_date	int	计划作业下一次运行的日期。
next_run_time	int	计划作业下一次运行的时间。
next_run_schedule_id	int	下一个运行的计划的标识号。
current_execution_status	int	当前的执行状态。
current_execution_step	sysname	作业中当前的执行步骤。
current_retry_attempt	int	如果作业正在运行，并且已经重试过该步骤，那么这就是当前的重试尝试。
has_step	int	作业具有的作业步骤数。
has_schedule	int	作业具有的作业计划数。
has_target	int	作业具有的目标服务器数。
type	int	作业类型： 1 = 本地作业。 2 = 多服务器作业。 0 = 作业没有目标服务器。

注释

此过程列出有关附加到指定计划的作业的信息。

权限

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

• SQLAgentUserRole

• SQLAgentReaderRole

• SQLAgentOperatorRole

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

SQLAgentUserRole 的成员只能查看其所拥有作业的状态。

示例

以下示例列出附加到 NightlyJobs 计划的作业。

USE msdb ;
GO

EXEC sp_help_jobs_in_schedule
    @schedule_name = N'NightlyJobs' ;
GO

请参阅

参考

SQL Server 代理存储过程 (Transact-SQL)

sp_add_schedule (Transact-SQL)

sp_attach_schedule (Transact-SQL)

sp_delete_schedule (Transact-SQL)

sp_detach_schedule (Transact-SQL)