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 = ] N'job_name' ]
[ , [ @step_id = ] step_id ]
[ , [ @step_name = ] N'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 uniqueidentifier, con un valor predeterminado de NULL
.
Se deben especificar @job_id o @job_name , pero no se pueden especificar ambos.
[ @job_name = ] N'job_name'
Nombre del trabajo. @job_name es sysname, con un valor predeterminado de NULL
.
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 en el 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 = ] N'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
(erróneo).
Conjunto 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, es step_id 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 del paso de trabajo, en megabytes (MB). |
log |
nvarchar(max) | Salida del registro de pasos de trabajo. |
Comentarios
sp_help_jobsteplog
está en la base de msdb
datos.
Permisos
Este procedimiento almacenado es propiedad del rol db_owner . Puede conceder EXECUTE
permisos para cualquier usuario, pero estos permisos se pueden invalidar durante una actualización de SQL Server.
A otros usuarios se les debe conceder uno de los siguientes Agente SQL Server roles fijos de base de datos en la msdb
base de datos:
- 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 del paso de trabajo, para el 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 del paso de trabajo, sobre el primer paso de trabajo para el 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