Compartilhar via

sp_help_jobserver (Transact-SQL)

  • Artigo

Aplica-se: SQL Server

Retorna informações sobre o servidor para um determinado trabalho.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_help_jobserver
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @show_last_run_details = ] show_last_run_details ]
[ ; ]

Argumentos

@job_id [ = ] 'job_id'

O número de identificação do trabalho para o qual as informações devem ser 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 cujas informações serão retornadas. @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.

@show_last_run_details [ = ] show_last_run_details

Se as informações de execução da última execução fazem parte do conjunto de resultados. @show_last_run_details é tinyint, com um padrão de 0.

  • 0 não inclui informações de última execução.
  • 1 Inclui informações de última execução.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto de resultados

Nome da coluna Tipo de dados Descrição
server_id int Número de identificação do servidor de destino.
server_name nvarchar(30) Nome do computador do servidor de destino.
enlist_date datetime Data em que o servidor de destino foi inscrito no servidor mestre.
last_poll_date datetime Data em que o servidor de destino fez a última sondagem no servidor mestre.

Se sp_help_jobserver for executado com @show_last_run_details definido como 1, o conjunto de resultados terá essas colunas extras.

Nome da coluna Tipo de dados Descrição
last_run_date int Data em que a execução do trabalho foi iniciada pela última vez nesse servidor de destino.
last_run_time int Hora em que a execução do trabalho foi iniciada pela última vez nesse servidor.
last_run_duration int Duração do trabalho na última vez em que foi executado nesse servidor de destino (em segundos).
last_outcome_message nvarchar(1024) Descreve o último resultado do trabalho.
last_run_outcome int Resultado do trabalho na última vez em que foi executado neste servidor:

0 = Falha
1 = Bem sucedido
3 = Cancelado
5 = Desconhecido

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 do SQLAgentUserRole só podem exibir informações de trabalhos que possuem.

Exemplos

O exemplo a seguir retorna informações, incluindo as informações da última execução, sobre o trabalho NightlyBackups.

USE msdb;
GO

EXEC dbo.sp_help_jobserver
    @job_name = N'NightlyBackups',
    @show_last_run_details = 1;
GO

Conteúdo relacionado