Compartilhar via

sp_help_jobs_in_schedule (Transact-SQL)

  • Artigo

Aplica-se: 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 = ] N'schedule_name' ]
    [ , [ @schedule_id = ] schedule_id ]
[ ; ]

Argumentos

@schedule_id [ = ] schedule_id

O identificador da agenda para o qual listar informações. @schedule_id é int, com um padrão de NULL.

Pode ser especificado @schedule_id ou @schedule_name .

@schedule_name [ = ] N'schedule_name'

O nome da agenda para a qual listar informações. @schedule_name é sysname, com um padrão de NULL.

Pode ser especificado @schedule_id ou @schedule_name .

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto 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.
enabled tinyint Indica se o trabalho está habilitado, para que possa 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 é 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 que para 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 que para 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 que para 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 que para 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 = Bem sucedido
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 tiver sido repetida, esse valor será 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.
type 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

Você pode conceder EXECUTE permissões nesse procedimento, mas essas permissões podem ser substituídas durante uma atualização do SQL Server.

Outros usuários devem receber uma das seguintes funções de banco de dados fixas do msdb SQL Server Agent no banco de dados:

  • 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

Conteúdo relacionado