Compartilhar via

sp_help_jobsteplog (Transact-SQL)

  • Artigo

Aplica-se: SQL Server

Retorna metadados sobre um log de etapas de trabalho específico do SQL Server Agent. 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 = ] N'job_name' ]
    [ , [ @step_id = ] step_id ]
    [ , [ @step_name = ] N'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 é uniqueidentifier, com um padrão de NULL.

Tanto @job_id quanto @job_name devem ser especificados, mas ambos não podem ser especificados.

@job_name [ = ] N'job_name'

O nome do trabalho. @job_name é sysname, com um padrão de NULL.

Tanto @job_id quanto @job_name devem ser especificados, 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 [ = ] N'step_name'

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

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto 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, ela 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 do log da etapa de trabalho, em megabytes (MB).
log nvarchar(max) Saída do log de etapas do trabalho.

Comentários

sp_help_jobsteplog está no msdb banco de dados.

Permissões

Você pode conceder EXECUTE permissões nesse procedimento, mas essas permissões podem ser substituídas durante uma atualização do SQL Server.

Outros usuários devem receber uma das seguintes funções de banco de dados fixas do msdb SQL Server Agent no banco de dados:

  • 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 de log de etapas de trabalho para etapas de trabalho que eles possuem.

Exemplos

R. 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 de log da etapa de trabalho, para o trabalho chamado 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 de log da etapa de trabalho, sobre a primeira etapa de trabalho para o trabalho chamado Weekly Sales Data Backup.

USE msdb;
GO

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

Conteúdo relacionado