Transact-SQL 参考

sp_help_jobserver

为给定的作业返回有关服务器的信息。

语法

sp_help_jobserver [ @job_id = ] job_id |
    [ @job_name = ] 'job_name'
    
[ , [ @show_last_run_details = ] show_last_run_details ]

参数

[@job_id =] job_id

是为其返回信息的作业标识号。job_id 的数据类型为 uniqueidentifier,默认值为 NULL。

[@show_last_run_detail =] 'job_name'

是为其返回信息的作业名。job_name 的数据类型为 sysname,默认设置为 NULL。

说明  必须指定 job_idjob_name,但不能两个都指定。

[@show_last_run_details =] show_last_run_details

表示上一次运行的执行信息是否包含在结果集中。show_last_run_details 的数据类型为 tinyint,默认值为 0。0 表示不包括上一次的运行信息,但 1 包括。

返回代码值

0(成功)或 1(失败)

结果集
列名 数据类型 描述
server_id int 目标服务器的标识号。
server_name nvarchar(30) 目标服务器的计算机名称。
enlist_date datetime 将目标服务器登记到主服务器 (MSX) 的日期。
last_poll_date datetime 目标服务器上一次轮询 MSX 的日期。

如果将 show_last_run_details 设置成 1,并且执行 sp_help_jobserver,那么结果集中有下面这些额外的列。

列名 数据类型 描述
last_run_date Int 在这个目标服务器上,作业上一次开始执行的日期。
last_run_time Int 作业上一次在这台服务器上开始执行的时间。
last_run_duration Int 作业上一次在这台目标服务器上运行所持续的时间(以秒为单位)。
last_outcome_message nvarchar(1024) 作业上一次在这个服务器上运行的结果:

0 = 失败
1 = 成功
3 = 取消
5 = 未知


权限

sysadmin 固定服务器角色和 db_owner 固定数据库角色在默认情况下有执行此过程的权限,他们可以将权限授予其他用户。

示例

下面的示例返回有关 Archive Tables 作业的信息,其中包括上一次运行的信息。

USE msdb
EXEC sp_help_jobserver @job_name = 'Archive Tables',
   @show_last_run_details = 1

请参见

sp_add_jobserver

sp_delete_jobserver

系统存储过程