sp_help_jobsteplog (Transact-SQL)

Aplica-se a:SQL Server

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

Convenções de sintaxe de 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 de log da etapa de trabalho serão retornadas. job_id é int, com um padrão de NULL.

[ @job_name = ] 'job_name' O nome do trabalho. job_name é sysname, com um NULL padrão.

Observação

É necessário especificar job_id ou job_name , mas ambos não podem ser especificados.

[ @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 um padrão de NULL.

[ @step_name = ] 'step_name' O nome da etapa no trabalho. step_name é sysname, com um padrão de NULL.

Valores do 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 a etapa for a primeira etapa do trabalho, sua 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 do SQLAgentUserRole só podem exibir metadados de log da etapa de trabalho para as etapas de trabalho que possuem.

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

sp_add_jobstep (Transact-SQL)
sp_delete_jobstep (Transact-SQL)
sp_help_jobstep (Transact-SQL)
sp_delete_jobstep (Transact-SQL)
sp_delete_jobsteplog (Transact-SQL)
Procedimentos armazenados do SQL Server Agent (Transact-SQL)