Compartir a través de


sp_help_jobsteplog (Transact-SQL)

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

Icono de vínculo a temasConvenciones 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 información del registro de pasos de trabajo. job_id es de tipo int y su valor predeterminado es NULL.

  • [ @job_name =] 'job_name'
    Nombre del trabajo. job_name es de tipo sysname y su valor predeterminado es NULL.

    Nota

    Se debe especificar job_id o job_name, pero no ambos.

  • [ @step_id =] step_id
    Número de identificación del paso en el trabajo. Si no se especifica, se incluirán todos los pasos del trabajo. step_id es de tipo int y su valor predeterminado es NULL.

  • [ @step_name =] 'step_name'
    Nombre del paso en el trabajo. step_name es de tipo sysname y su valor predeterminado es NULL.

Valores de código de retorno

0 (correcto) o 1 (error)

Conjuntos de resultados

Nombre de 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 un paso es el primero 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 se encuentra en la base de datos msdb.

Permisos

De manera predeterminada, este procedimiento almacenado lo pueden ejecutar los miembros de la función fija de servidor sysadmin. Al resto de usuarios se les debe conceder una de las siguientes funciones fijas de base de datos del Agente SQL Server en la base de datos msdb:

  • SQLAgentUserRole

  • SQLAgentReaderRole

  • SQLAgentOperatorRole

Para obtener detalles sobre los permisos de estas funciones, vea Funciones fijas de base de datos del Agente SQL Server.

Los miembros de SQLAgentUserRole sólo pueden ver los metadatos del registro de pasos de trabajo de los pasos de trabajo que les pertenecen.

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