Partilhar via


sp_help_jobserver (Transact-SQL)

Aplica-se a:SQL Server

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

Transact-SQL convenções de sintaxe

Sintaxe

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

Arguments

[ @job_id = ] 'job_id'

O número de identificação do emprego para devolver a informação. @job_id é um identificador único, com um padrão de NULL.

Ou @job_id ou @job_name devem ser especificados, mas nenhum dos dois pode ser especificado.

[ @job_name = ] N'job_name'

O nome do trabalho para o qual deves devolver informações. @job_name é sysname, com o padrão de NULL.

Ou @job_id ou @job_name devem ser especificados, mas nenhum dos dois pode ser especificado.

[ @show_last_run_details = ] show_last_run_details

Se a informação de execução da última execução faz parte do conjunto de resultados. @show_last_run_details é minyint, com um padrão de 0.

  • 0 Não inclui informações sobre a última corrida.
  • 1 Inclui informação sobre a última corrida.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Conjunto de resultados

Nome da coluna Tipo de dados Description
server_id int Número de identificação do servidor alvo.
server_name nvarchar(30) Nome do computador do servidor alvo.
enlist_date datetime Data a data do servidor alvo que se inscreveu no servidor mestre.
last_poll_date datetime A data em que o servidor alvo fez a última consulta ao servidor mestre.

Se sp_help_jobserver for executado com @show_last_run_details definido em 1, o conjunto de resultados tem estas colunas extra.

Nome da coluna Tipo de dados Description
last_run_date int Data a última execução da tarefa iniciada neste servidor alvo.
last_run_time int A última vez que o trabalho começou a ser executado neste servidor.
last_run_duration int Duração do trabalho da última vez que correu neste servidor alvo (em segundos).
last_outcome_message nvarchar(1024) Descreve o resultado final do trabalho.
last_run_outcome int Resultado do trabalho da última vez que correu neste servidor:

0 = Falhou
1 = Sucedeu
3 = Cancelado
5 = Desconhecido

Permissions

Pode conceder EXECUTE permissões neste procedimento, mas essas permissões podem ser anuladas durante uma atualização do SQL Server.

Outros utilizadores devem receber um dos seguintes papéis fixos de base de dados SQL Server Agent na msdb base de dados:

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

Para detalhes sobre as permissões destes papéis, consulte Funções de Base de Dados Fixas do Agente SQL Server.

Os membros do SQLAgentUserRole só podem visualizar informação de trabalhos que possuem.

Examples

O exemplo seguinte devolve informações, incluindo informações de última corrida, sobre o NightlyBackups trabalho.

USE msdb;
GO

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