sp_help_jobactivity (Transact-SQL)

Lista informações sobre o estado do tempo de execução de trabalhos do SQL Server Agent.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

sp_help_jobactivity { [ @job_id = ] job_id | [ @job_name = ] 'job_name' }
     [ , [ @session_id = ] session_id ]

Argumentos

  • [ @job_id =] job_id
    O número de identificação do trabalho. job_idé uniqueidentifier, com um padrão NULL.

  • [ @job_name =] 'job_name'
    O nome do trabalho. job_nameé sysname, com um 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.

  • [ @session_id = ] session_id
    A ID de sessão sobre a qual as informações serão relatadas. session_id é int, com um padrão NULL.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Retorna o seguinte conjunto de resultados:

Nome da coluna

Tipo de dados

Descrição

session_id

int

Número de identificação da sessão do agente.

job_id

uniqueidentifier

Identificador do trabalho.

job_name

sysname

Nome do trabalho.

run_requested_date

datetime

Momento em que foi solicitada a execução do trabalho.

run_requested_source

sysname

A origem da solicitação para executar o trabalho. Um dos seguintes:

1 = Executar em um agendamento

2 = Executar em resposta a um alerta

3 = Executar na inicialização

4 = Executar pelo usuário

6 = Executar em um agendamento ocioso de CPU

queued_date

datetime

Data em que a solicitação foi colocada em fila. NULL se o trabalho foi executado diretamente.

start_execution_date

datetime

Data em que o trabalho foi atribuído a um thread executável.

last_executed_step_id

int

A ID de etapa da última etapa de trabalho executada.

last_exectued_step_date

datetime

A data em que começou a execução da última etapa de trabalho.

stop_execution_date

datetime

A data em que o trabalho parou de ser executado.

next_scheduled_run_date

datetime

Próxima data em que o trabalho foi agendado para ser executado.

job_history_id

int

Identificador para o histórico de trabalho na tabela de histórico de trabalho.

message

nvarchar(1024)

Mensagem produzida durante a última execução do trabalho.

run_status

int

Status retornado da última execução do trabalho:

0 = Erro, falha

1 = Obteve êxito

3 = Cancelada

5 = Status desconhecido

operator_id_emailed

int

Número de ID do operador notificado por email na conclusão do trabalho.

operator_id_netsent

int

Número de ID do operador notificado via net send na conclusão do trabalho.

operator_id_paged

int

Número de ID do operador notificado por pager na conclusão do trabalho.

Comentários

Esse procedimento fornece um instantâneo do status atual dos trabalhos em execução. Os resultados retornados representam as informações no momento em que a solicitação é processada.

O SQL Server Agent cria uma nova ID de sessão sempre que seu serviço é iniciado. A ID de sessão é armazenada na tabela msdb.dbo.syssessions.

Quando nenhuma session_id é fornecida, ele lista as informações sobre a sessão mais recente.

Quando nenhum job_name ou job_id é fornecida, ele lista as informações para todos os trabalhos.

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.

Somente membros de sysadmin podem exibir a atividade para trabalhos de propriedade de outros usuários.

Exemplos

O exemplo a seguir lista a atividade de todos os trabalhos que o usuário atual tem permissão para exibir.

USE msdb ;
GO

EXEC dbo.sp_help_jobactivity ;
GO