Share via

  • Artigo

sp_help_jobserver (Transact-SQL)

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

Ícone de vínculo de tópicoConvenções de sintaxe 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 as informações são retornadas. job_id é uniqueidentifier, com um padrão NULL.

  • [ @job_name= ] 'job_name'
    O nome do trabalho para o qual as informações devem ser retornadas. job_name é sysname, com 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.

  • [ @show_last_run_details= ] show_last_run_details
    Especifica se as informações 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 as informações da última execução e 1 inclui.

Valores de 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 de mestre.

last_poll_date

datetime

Data em que o servidor de destino fez a última sondagem no servidor de 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 nesse 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 de SQLAgentUserRole podem exibir apenas as informações dos 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