sp_help_jobsteplog (Transact-SQL)

适用于：SQL Server

返回有关特定SQL Server 代理作业步骤日志的元数据。 sp_help_jobsteplog 不返回实际日志。

Transact-SQL 语法约定

语法

  
sp_help_jobsteplog { [ @job_id = ] 'job_id' | [ @job_name = ] 'job_name' }  
     [ , [ @step_id = ] step_id ]  
     [ , [ @step_name = ] 'step_name' ]  

参数

[ @job_id = ] 'job_id' 要为其返回作业步骤日志信息的作业标识号。 job_id 为 int，默认值为 NULL。

[ @job_name = ] 'job_name' 作业的名称。 job_name 为 sysname，默认为 NULL。

注意

必须指定 job_id 或 job_name ，但不能同时指定两者。

[ @step_id = ] step_id 作业中步骤的标识号。 如果尚未包括，则包括作业中的所有步骤。 step_id 为 int，默认值为 NULL。

[ @step_name = ] 'step_name' 作业中步骤的名称。 step_name 为 sysname，默认值为 NULL。

返回代码值

0（成功）或 1（失败）

结果集

列名称	数据类型	说明
job_id	uniqueidentifier	作业的唯一标识符。
job_name	sysname	作业的名称。
step_id	int	作业中步骤的标识符。 例如，如果步骤是作业中的第一步，则其 step_id 为 1。
step_name	sysname	作业中步骤的名称。
step_uid	uniqueidentifier	作业中步骤的唯一标识符（由系统生成）。
date_created	datetime	创建步骤的日期。
date_modified	datetime	上次修改步骤的日期。
log_size	float	作业步骤日志的大小 (MB)。
log	nvarchar(max)	作业步骤日志输出。

备注

sp_help_jobsteplog 位于 msdb 数据库中。

权限

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

• SQLAgentUserRole

• SQLAgentReaderRole

• SQLAgentOperatorRole

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

SQLAgentUserRole 的成员只能查看其拥有的作业步骤的作业步骤日志元数据。

示例

A. 返回特定作业中所有步骤的作业步骤日志信息

以下示例返回作业 Weekly Sales Data Backup 的所有作业步骤日志信息。

USE msdb ;  
GO  
  
EXEC dbo.sp_help_jobsteplog  
    @job_name = N'Weekly Sales Data Backup' ;  
GO  

B. 返回有关特定作业步骤的作业步骤日志信息

以下示例返回作业 Weekly Sales Data Backup 的第一个作业步骤的作业步骤日志信息。

USE msdb ;  
GO  
  
EXEC dbo.sp_help_jobsteplog  
    @job_name = N'Weekly Sales Data Backup',  
    @step_id = 1 ;  
GO  

另请参阅

sp_add_jobstep (Transact-SQL)
sp_delete_jobstep (Transact-SQL)
sp_help_jobstep (Transact-SQL)
sp_delete_jobstep (Transact-SQL)
sp_delete_jobsteplog (Transact-SQL)
SQL Server 代理存储过程 (Transact-SQL)