sp_help_jobactivity (Transact-SQL)

适用于SQL Server

列出有关SQL Server 代理作业的运行时状态的信息。

Transact-SQL 语法约定

语法

sp_help_jobactivity
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @session_id = ] session_id ]
[ ; ]

参数

[ @job_id = ] 'job_id'

作业标识号。 @job_id是 uniqueidentifier,默认值为 NULL.

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

[ @job_name = ] N'job_name'

作业的名称。 @job_name为 sysname,默认值为 NULL.

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

[ @session_id = ] session_id

要报告相关信息的会话 ID。 @session_id为 int,默认值为 NULL.

返回代码值

0(成功)或 1(失败)。

结果集

返回以下结果集:

列名称 数据类型 说明
session_id int 代理会话标识号。
job_id uniqueidentifier 作业标识符。
job_name sysname 作业的名称。
run_requested_date datetime 请求运行作业的时间。
run_requested_source sysname 请求运行作业的请求源。 下列其中一项:

1 = 按计划运行
2 = 响应警报时运行
3 = 启动时运行
4 = 用户运行
6 = 在 CPU 空闲计划上运行
queued_date datetime 指定请求排队时间。 NULL 如果作业直接运行,则为
start_execution_date datetime 将作业分配给可运行线程的时间。
last_executed_step_id int 最近运行的作业步骤的 ID。
last_exectued_step_date datetime 最近运行的作业步骤开始运行的时间。
stop_execution_date datetime 作业停止运行的时间。
next_scheduled_run_date datetime 计划下一次作业运行的时间。
job_history_id int 作业历史记录表中作业历史记录的标识符。
message nvarchar(1024) 上次运行作业期间产生的消息。
run_status int 作业上次运行时返回的状态:

0 = 错误失败
1 = Succeeded
3 = 已取消
5 = 状态未知
operator_id_emailed int 作业完成时通过电子邮件通知的操作员的 ID 号。
operator_id_netsent int 作业完成后通过 net send 通知的操作员的 ID 号。
operator_id_paged int 作业完成时通过寻呼通知的操作员的 ID 号。

注解

此过程可提供作业的当前状态快照。 返回的结果表示处理请求时的有关信息。

SQL Server 代理每次启动代理服务时创建会话 ID。 会话 ID 存储在表 msdb.dbo.syssessions**中。

如果未 提供@session_id ,则列出有关最近会话的信息。

如果未 提供@job_name@job_id ,则列出所有作业的信息。

权限

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

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

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

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

只有 sysadmin 的成员才能查看其他用户拥有的作业的活动。

示例

以下示例列出了当前用户有权查看的全部作业的活动。

USE msdb;
GO

EXEC dbo.sp_help_jobactivity;
GO