sp_help_jobactivity (Transact-SQL)

  • 项目

适用于：SQL Server

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

Transact-SQL 语法约定

语法

  
sp_help_jobactivity { [ @job_id = ] job_id | [ @job_name = ] 'job_name' }  
     [ , [ @session_id = ] session_id ]

参数

[ @job_id = ] job_id 作业标识号。 job_id为 uniqueidentifier，默认值为 NULL。

[ @job_name = ] '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 = 成功

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 ，则列出所有作业的信息。

权限

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

  • SQLAgentUserRole

  • SQLAgentReaderRole

  • SQLAgentOperatorRole

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

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

示例

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

USE msdb ;  
GO  
  
EXEC dbo.sp_help_jobactivity ;  
GO

另请参阅

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