sp_help_jobactivity (Transact-SQL)

列出有关 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)