• Artigo

sp_help_jobsteplog (Transact-SQL)

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ópicoConvenções de 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 um padrão NULL.

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

    ObservaçãoObservação

    É necessário especificar a job_id ou o 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 no trabalho serão incluídas. step_id é int, com um padrão NULL.

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

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