sp_help_jobs_in_schedule (Transact-SQL)
Retorna informações sobre os trabalhos para os quais uma agenda específica é anexada.
.gif "Ícone de vínculo de tópico")
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 o schedule_id ou a 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. |
name |
sysname |
Nome do trabalho. |
ativado |
tinyint |
Indica se o trabalho está habilitado para ser executado. |
description |
nvarchar(512) |
Descrição para o trabalho. |
start_step_id |
int |
ID da etapa do trabalho em que execução deve começar. |
category |
sysname |
Categoria do trabalho. |
owner |
sysname |
Proprietário do trabalho. |
notify_level_eventlog |
int |
Bitmask indicando sob quais circunstâncias um evento de notificação deve ser registrado no log de aplicativo do Microsoft Windows. Pode ser um destes valores: 0 = Nunca 1 = Quando um trabalho obtém êxito 2 = Quando o trabalho falhar 3 = Quando o trabalho for concluído (independentemente do resultado) |
notify_level_email |
int |
Bitmask indicando 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 indicando 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 indicando 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 indicando sob quais circunstâncias um trabalho deve ser excluído quando é 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 = Falhou 1 = Teve êxito 3 = Cancelado 5 = Desconhecido |
next_run_date |
int |
Data seguinte em que o trabalho foi agendado para ser executado. |
next_run_time |
int |
Hora seguinte em que o trabalho foi agendado para ser executado. |
next_run_schedule_id |
int |
Número de identificação do próxima agenda 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 sendo executado e a etapa foi tentada novamente, esta é a nova tentativa atual. |
has_step |
int |
Número de etapas que o trabalho possui. |
has_schedule |
int |
Número de agendas 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 multiservidor. 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 Agent do SQL Server 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