sp_help_jobactivity (Transact-SQL)

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

Convençõ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çã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

Consulte também

Referência

Procedimentos armazenados do SQL Server Agent (Transact-SQL)