sp_help_jobactivity (Transact-SQL)
列出有关 SQL Server 代理作业的运行时状态的信息。
语法
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 |
作业上次运行时返回的状态。 |
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