sp_help_jobserver (Transact-SQL)

  • Artigo

Aplica-se a: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 = ] '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 retornar informações. job_id é uniqueidentifier, com um padrão de NULL.

[ @job_name = ] 'job_name' O nome do trabalho para o qual retornar informações. job_name é sysname, com um padrão de NULL.

Observação

Job_id oujob_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 e 1 inclui.

Valores do código de retorno

0 (êxito) ou 1 (falha)

Conjuntos 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 adicionais.

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 = Êxito

3 = Cancelado

5 = Desconhecido

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 informações para 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

Consulte Também

sp_add_jobserver (Transact-SQL)
sp_delete_jobserver (Transact-SQL)
Procedimentos armazenados do sistema (Transact-SQL)