sp_help_jobserver (Transact-SQL)

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

语法

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。
  • [ @job_name= ] 'job_name'
    要为其返回信息的作业的名称。job_name 的数据类型为 sysname,默认值为 NULL。

    ms179858.note(zh-cn,SQL.90).gif注意:
    必须指定 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

将目标服务器登记到主服务器的日期。

last_poll_date

datetime

目标服务器上一次轮询主服务器的日期。

如果将 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)

说明作业上一次运行的结果。

last_run_outcome

int

作业上一次在此服务器上运行的结果:

0 = 失败

1 = 成功

3 = 已取消

5 = 未知

权限

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

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

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

SQLAgentUserRole 的成员只可以查看其所拥有作业的信息。

示例

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

USE msdb ;
GO

EXEC dbo.sp_help_jobserver
    @job_name = N'NightlyBackups',
    @show_last_run_details = 1 ;
GO

请参阅

参考

sp_add_jobserver (Transact-SQL)
sp_delete_jobserver (Transact-SQL)
系统存储过程 (Transact-SQL)

帮助和信息

获取 SQL Server 2005 帮助