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.
.gif "Icono de vínculo a temas")
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. |
Notas
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