Partilhar via

sp_help_jobs_in_schedule (Transact-SQL)

Aplica-se a:SQL Server

Devolve informações sobre os trabalhos a que um determinado horário está associado.

Transact-SQL convenções de sintaxe

Sintaxe

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

Arguments

[ @schedule_id = ] schedule_id

O identificador do horário para 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 do horário para listar a informação. @schedule_name é sysname, com um padrão de NULL.

Pode ser especificado @schedule_id ou @schedule_name .

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Conjunto de resultados

Devolve o seguinte conjunto de resultados:

Nome da coluna Tipo de dados Description
job_id uniqueidentifier ID exclusivo do trabalho.
originating_server nvarchar(30) Nome do empregado de onde veio o trabalho.
name sysname Nome do trabalho.
enabled tinyint Indica se o trabalho está ativado, para que possa ser executado.
description nvarchar(512) Descrição do trabalho.
start_step_id int ID do passo do trabalho onde a execução deve começar.
category sysname Categoria de trabalho.
owner sysname Proprietário do trabalho.
notify_level_eventlog int Máscara de bits indica em que circunstâncias um evento de notificação deve ser registado no registo de aplicações do Microsoft Windows. Pode ser um destes valores:

0 = Nunca
1 = Quando um trabalho tem sucesso
2 = Quando o trabalho falha
3 = Sempre que o trabalho é concluído (independentemente do resultado do trabalho)
notify_level_email int Bitmask indica em que circunstâncias um e-mail 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 A máscara de bits indica em que 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 indica em que 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 Envie um e-mail com o nome do operador para notificar.
notify_netsend_operator sysname Nome do computador ou utilizador utilizado ao enviar mensagens de rede.
notify_page_operator sysname Nome do computador ou utilizador utilizado ao enviar uma página.
delete_level int Bitmask indica em que circunstâncias o trabalho deve ser eliminado quando um trabalho é concluído. Os valores possíveis são os mesmos que para notify_level_eventlog.
date_created datetime Data em que o cargo foi criado.
date_modified datetime Data em que o trabalho foi modificado pela última vez.
version_number int Versão do trabalho (atualizada automaticamente cada vez que o trabalho é modificado).
last_run_date int Data da última vez que o trabalho começou a execução.
last_run_time int A última vez que o trabalho começou a ser executado.
last_run_outcome int Resultado do trabalho na última vez que foi exibido:

0 = Falhou
1 = Sucedeu
3 = Cancelado
5 = Desconhecido
next_run_date int Data em que o trabalho está agendado para a próxima sessão.
next_run_time int Hora em que o trabalho está agendado para a próxima emissão.
next_run_schedule_id int Número de identificação do calendário da próxima corrida.
current_execution_status int Estado atual da execução.
current_execution_step sysname Etapa atual de execução no trabalho.
current_retry_attempt int Se a tarefa estiver a correr e o passo tiver sido retentado, este valor é a tentativa de retentativa atual.
has_step int Número de passos do trabalho que o trabalho tem.
has_schedule int Número de horários de trabalho que o trabalho tem.
has_target int Número de servidores-alvo que o trabalho tem.
type int Tipo de trabalho:

1 = Trabalho local.
2 = Trabalho multiservidor.
0 = O trabalho não tem servidores-alvo.

Observações

Este procedimento lista informações sobre tarefas associadas ao cronograma especificado.

Permissions

Pode conceder EXECUTE permissões neste procedimento, mas essas permissões podem ser anuladas durante uma atualização do SQL Server.

Outros utilizadores devem receber um dos seguintes papéis fixos de base de dados SQL Server Agent na msdb base de dados:

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

Para detalhes sobre as permissões destes papéis, consulte Funções de Base de Dados Fixas do Agente SQL Server.

Os membros do SQLAgentUserRole só podem visualizar o estado dos trabalhos que possuem.

Examples

O exemplo seguinte lista as funções associadas ao NightlyJobs calendário.

USE msdb;
GO

EXECUTE sp_help_jobs_in_schedule @schedule_name = N'NightlyJobs';
GO

Conteúdo relacionado

  • Last updated on