sp_help_jobs_in_schedule (Transact-SQL)
返回有关附加了特定计划的作业的信息。
.gif "主题链接图标")
语法
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