sp_help_jobs_in_schedule (Transact-SQL)

  • Artigo

Aplica-se a:SQL Server

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

Convenções de sintaxe de Transact-SQL

Sintaxe

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

Argumentos

[ @schedule_id = ] schedule_id O identificador do agendamento 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 do agendamento para o qual listar informações. schedule_name é sysname, sem padrão. Pode ser especificado schedule_id ou schedule_name .

Valores do 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.
name sysname Nome do trabalho.
Habilitado tinyint Indica se o trabalho está habilitado para ser executado.
descrição 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.
proprietário 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 é bem-sucedido

2 = Quando o trabalho falha

3 = Sempre que o trabalho for concluído (independentemente do resultado do trabalho)
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 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 = Êxito

3 = Cancelado

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 = O trabalho não tem servidores 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 do 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

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)