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

作业具有的目标服务器数。

类型

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)