Share via


sp_help_jobsteplog (Transact-SQL)

Se aplica a:SQL Server

Devuelve metadatos sobre un registro de pasos de trabajo de Agente SQL Server específico. sp_help_jobsteplog no devuelve el registro real.

Convenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

[ @job_id = ] 'job_id' Número de identificación del trabajo para el que se va a devolver la información del registro del paso de trabajo. job_id es int, con un valor predeterminado de NULL.

[ @job_name = ] 'job_name' Nombre del trabajo. job_name es sysname, con un valor NULL predeterminado.

Nota

Se deben especificar job_id o job_name , pero no se pueden especificar ambos.

[ @step_id = ] step_id Número de identificación del paso del trabajo. Si no se especifica, se incluirán todos los pasos del trabajo. step_id es int, con un valor predeterminado de NULL.

[ @step_name = ] 'step_name' Nombre del paso en el trabajo. step_name es sysname, con un valor predeterminado de NULL.

Valores de código de retorno

0 (correcto) o 1 (error)

Conjuntos de resultados

Nombre de la columna Tipo de datos Descripción
job_id uniqueidentifier Identificador único del trabajo.
job_name sysname Nombre del trabajo.
step_id int Identificador del paso en el trabajo. Por ejemplo, si el paso es el primer paso del trabajo, su step_id es 1.
step_name sysname Nombre del paso en el trabajo.
step_uid uniqueidentifier Identificador único del paso en el trabajo (generado por el sistema).
date_created datetime Fecha de creación del paso.
date_modified datetime Fecha de la última modificación del paso.
log_size float Tamaño del registro de pasos de trabajo, en megabytes (MB).
log nvarchar(max) Salida del registro de pasos de trabajo.

Comentarios

sp_help_jobsteplog está en la base de datos msdb .

Permisos

De forma predeterminada, los miembros del rol fijo de servidor sysadmin pueden ejecutar este procedimiento almacenado. Al resto de usuarios se les debe conceder uno de los siguientes roles fijos de base de datos del Agente SQL Server en la base de datos msdb :

  • SQLAgentUserRole

  • SQLAgentReaderRole

  • SQLAgentOperatorRole

Para detalles sobre los permisos de estos roles, consulte Roles fijos de base de datos del Agente SQL Server.

Los miembros de SQLAgentUserRole solo pueden ver los metadatos del registro de pasos de trabajo para los pasos de trabajo que poseen.

Ejemplos

A. Devolver información del registro de pasos de trabajo para todos los pasos de un trabajo específico

En el ejemplo siguiente se devuelve toda la información del registro de pasos de trabajo del trabajo denominado Weekly Sales Data Backup.

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

B. Devolver información del registro de pasos de trabajo para un paso de trabajo específico

En el ejemplo siguiente se devuelve información del registro de pasos de trabajo para el primer paso de trabajo del trabajo denominado Weekly Sales Data Backup.

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

Consulte también

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)
Procedimientos almacenados del Agente SQL Server (Transact-SQL)