sp_help_jobsteplog (Transact-SQL)

Artigo
06/18/2013

Retorna metadados sobre um log de etapas de trabalho específico do SQL Server Agent. sp_help_jobsteplog não retorna o log real.

Ícone de vínculo de tópico Convenções da sintaxe Transact-SQL

Sintaxe

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

Argumentos

[ @job_id =] 'job_id'
O número de identificação do trabalho para o qual as informações do log de etapas de trabalho serão retornadas. job_id é int, com o padrão de NULL.
[ @job_name =] 'job_name'
O nome do trabalho. job_name é sysname, com o padrão de NULL.

Observação

É necessário especificar job_id ou job_name, mas não é possível especificar ambos ao mesmo tempo.
[ @step_id =] step_id
O número de identificação da etapa no trabalho. Se não for incluído, todas as etapas do trabalho serão incluídas. step_id é int, com o padrão de NULL.
[ @step_name =] 'step_name'
O nome da etapa no trabalho. step_name é sysname, com o padrão de NULL.

Observação
É necessário especificar job_id ou job_name, mas não é possível especificar ambos ao mesmo tempo.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Nome da coluna	Tipo de dados	Descrição
job_id	uniqueidentifier	Identificador exclusivo do trabalho.
job_name	sysname	Nome do trabalho.
step_id	int	Identificador da etapa no trabalho. Por exemplo, se esta for a primeira etapa no trabalho, seu step_id será 1.
step_name	sysname	Nome da etapa no trabalho.
step_uid	uniqueidentifier	Identificador exclusivo da etapa (gerado pelo sistema) no trabalho.
date_created	datetime	Data em que a etapa foi criada.
date_modified	datetime	Data em que a etapa foi modificada pela última vez.
log_size	float	Tamanho, em MB (megabytes), do log de etapas do trabalho.
log	nvarchar(max)	Saída do log de etapas do trabalho.

Comentários

sp_help_jobsteplog está no banco de dados msdb.

Permissões

Por padrão, os membros da função de servidor fixa sysadmin podem executar este procedimento armazenado. Deve ser concedida a outros usuários uma das seguintes funções de banco de dados fixas do SQL Server Agent no banco de dados msdb:

SQLAgentUserRole
SQLAgentReaderRole
SQLAgentOperatorRole

Para obter detalhes sobre as permissões dessas funções, consulte Funções de banco de dados fixas do SQL Server Agent.

Os membros de SQLAgentUserRole só podem exibir metadados do log de etapas de trabalho para as etapas de trabalho de sua propriedade.

Exemplos

A.Retorna informações do log de etapas de trabalho para todas as etapas em um trabalho específico

O exemplo a seguir retorna todas as informações do log de etapas de trabalho do trabalho nomeado Weekly Sales Data Backup.

USE msdb ;
GO

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

B.Retorna informações do log de etapas de trabalho sobre uma etapa de trabalho específica

O exemplo a seguir retorna informações do log de etapas de trabalho sobre a primeira etapa do trabalho nomeado Weekly Sales Data Backup.

USE msdb ;
GO

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

Consulte também

Referência

sp_add_jobstep (Transact-SQL)

sp_delete_jobstep (Transact-SQL)

sp_help_jobstep (Transact-SQL)