sp_help_jobs_in_schedule (Transact-SQL)

Retorna informações sobre os trabalhos para os quais uma agenda específica é anexada.

Convenções da sintaxe Transact-SQL

Sintaxe

sp_help_jobs_in_schedule 
     [ @schedule_name = ] 'schedule_name' ,
     [ @schedule_id = ] schedule_id

Argumentos

• [ @schedule_id = ] schedule_id
  O identificador da agenda para o qual listar informações. schedule_id é int, sem padrão. Pode ser especificado schedule_id ou schedule_name.

• [ @schedule_name = ] 'schedule_name'
  O nome da agenda para a qual listar informações. schedule_name é sysname, sem padrão. Pode ser especificado schedule_id ou schedule_name.

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
job_id	uniqueidentifier	A ID exclusiva do trabalho.
originating_server	nvarchar(30)	Nome do servidor do qual o trabalho originou.
nome	sysname	Nome do trabalho.
habilitado	tinyint	Indica se o trabalho está habilitado para ser executado.
description	nvarchar(512)	Descrição do trabalho.
start_step_id	int	ID da etapa do trabalho em que a execução deve começar.
category	sysname	Categoria do trabalho.
owner	sysname	Proprietário do trabalho.
notify_level_eventlog	int	Bitmask que indica sob quais circunstâncias um evento de notificação deve ser registrado no log de aplicativos do Microsoft Windows. Pode ser um destes valores: 0 = Nunca 1 = Quando um trabalho obtém êxito 2 = Quando o trabalho falhar 3 = Sempre que o trabalho for concluído (independentemente do resultado)
notify_level_email	int	Bitmask que indica sob quais circunstâncias um email de notificação deve ser enviado quando um trabalho é concluído. Os valores possíveis são os mesmos de notify_level_eventlog.
notify_level_netsend	int	Bitmask que indica sob quais circunstâncias uma mensagem de rede deve ser enviada quando um trabalho é concluído. Os valores possíveis são os mesmos de notify_level_eventlog.
notify_level_page	int	Bitmask que indica sob quais circunstâncias uma página deve ser enviada quando um trabalho é concluído. Os valores possíveis são os mesmos de notify_level_eventlog.
notify_email_operator	sysname	Nome de email do operador a ser notificado.
notify_netsend_operator	sysname	Nome do computador ou usuário usado ao enviar mensagens de rede.
notify_page_operator	sysname	Nome do computador ou usuário usado ao enviar uma página.
delete_level	int	Bitmask que indica sob quais circunstâncias o trabalho deve ser excluído quando for concluído. Os valores possíveis são os mesmos de notify_level_eventlog.
date_created	datetime	A data em que o trabalho foi criado.
date_modified	datetime	Data em que o trabalho foi modificado pela última vez.
version_number	int	Versão do trabalho (atualizada automaticamente sempre que o trabalho é modificado).
last_run_date	int	Data da última execução do trabalho.
last_run_time	int	Hora da última execução do trabalho.
last_run_outcome	int	Resultado do trabalho na última vez em que foi executado: 0 = Falha 1 = Obteve êxito 3 = Cancelada 5 = Desconhecido
next_run_date	int	Próxima data em que o trabalho foi agendado para ser executado.
next_run_time	int	Próxima hora em que o trabalho foi agendado para ser executado.
next_run_schedule_id	int	Número de identificação do próximo agendamento de execução.
current_execution_status	int	Status de execução atual.
current_execution_step	sysname	Etapa de execução atual no trabalho.
current_retry_attempt	int	Se o trabalho estiver em execução e a etapa foi repetida, esta é a tentativa de repetição atual.
has_step	int	Número de etapas que o trabalho possui.
has_schedule	int	Número de agendamentos que o trabalho possui.
has_target	int	Número de servidores de destino que o trabalho possui.
tipo	int	Tipo do trabalho: 1 = Trabalho local. 2 = Trabalho multisservidor. 0 = Trabalho não possui nenhum servidor de destino.

Comentários

Este procedimento lista informações sobre trabalhos anexados à agenda especificada.

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 só podem exibir o status dos trabalhos que possuem.

Exemplos

O exemplo a seguir lista os trabalhos anexados à agenda NightlyJobs.

USE msdb ;
GO

EXEC sp_help_jobs_in_schedule
    @schedule_name = N'NightlyJobs' ;
GO

Consulte também

Referência

Procedimentos armazenados do SQL Server Agent (Transact-SQL)

sp_add_schedule (Transact-SQL)

sp_attach_schedule (Transact-SQL)

sp_delete_schedule (Transact-SQL)

sp_detach_schedule (Transact-SQL)