Compartir a través de

sp_help_jobsteplog (Transact-SQL)

  • Artículo

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

Puede conceder EXECUTE permisos en este procedimiento, 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

Contenido relacionado