Partilhar via

sp_help_jobschedule (Transact-SQL)

Aplica-se a:SQL Server

Devolve informações sobre o agendamento de trabalhos utilizados pelo SQL Server Management Studio para realizar atividades automatizadas.

Transact-SQL convenções de sintaxe

Sintaxe

sp_help_jobschedule
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @schedule_name = ] N'schedule_name' ]
    [ , [ @schedule_id = ] schedule_id ]
    [ , [ @include_description = ] include_description ]
[ ; ]

Arguments

[ @job_id = ] 'job_id'

O número de identificação do trabalho. @job_id é um identificador único, com um padrão de NULL.

Ou @job_id ou @job_name devem ser especificados, mas nenhum dos dois pode ser especificado.

[ @job_name = ] N'job_name'

O nome da tarefa. @job_name é sysname, com o padrão de NULL.

Ou @job_id ou @job_name devem ser especificados, mas nenhum dos dois pode ser especificado.

[ @schedule_name = ] N'schedule_name'

O nome do item agendado para o trabalho. @schedule_name é sysname, com um padrão de NULL.

[ @schedule_id = ] schedule_id

O número de identificação do item agendado para o trabalho. @schedule_id é int, com um padrão de NULL.

[ @include_description = ] include_description

Especifica se deve incluir a descrição do cronograma no conjunto de resultados. @include_description é bit, com um padrão de 0.

  • Quando 0, a descrição do cronograma não está incluída no conjunto de resultados.
  • Quando 1, a descrição do calendário é incluída no conjunto de resultados.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Conjunto de resultados

Nome da coluna Tipo de dados Description
schedule_id int Número do identificador do horário.
schedule_name sysname Nome da agenda.
enabled int Quer o horário esteja ativado (1) ou não (0).
freq_type int Valor indica quando o trabalho deve ser executado.

1 = Uma vez
4 = Diário
8 = Semanal
16 = Mensal
32 = Mensalmente, em relação ao freq_interval
64 = Executar quando o serviço SQL Server Agent iniciar.
freq_interval int Dias em que o trabalho é executado. O valor depende do valor de freq_type. Para obter mais informações, consulte sp_add_schedule.
freq_subday_type int Unidades para freq_subday_interval. Para obter mais informações, consulte sp_add_schedule.
freq_subday_interval int Número de freq_subday_type períodos a ocorrer entre cada execução do trabalho. Para obter mais informações, consulte sp_add_schedule.
freq_relative_interval int Ocorrência do emprego agendado em freq_interval cada mês. Para obter mais informações, consulte sp_add_schedule.
freq_recurrence_factor int Número de meses entre a execução prevista do trabalho.
active_start_date int Data em que o calendário é ativado.
active_end_date int Data de fim do calendário.
active_start_time int Hora do dia em que o horário começa.
active_end_time int O horário do dia termina.
date_created datetime Data em que o calendário é criado.
schedule_description Nvarchar(4000) Uma descrição inglesa do anexo derivada de valores em msdb.dbo.sysschedules. Quando @include_description é 0, esta coluna contém texto a indicar que a descrição não foi solicitada.
next_run_date int A próxima data do calendário faz com que o trabalho corra.
next_run_time int O momento do cronograma faz com que o trabalho funcione.
schedule_uid uniqueidentifier Identificador para o horário.
job_count int Contagem de empregos devolvidos.

Observação

sp_help_jobschedule devolve valores das dbo.sysjobschedules tabelas do sistema and dbo.sysschedules em msdb.sysjobschedules atualizações a cada 20 minutos. Isto pode afetar os valores que são devolvidos por este procedimento armazenado.

Observações

Os parâmetros de sp_help_jobschedule só podem ser usados em certas combinações. Se @schedule_id for especificado, @job_id e @job_name não podem ser especificados. Caso contrário, os parâmetros @job_id ou @job_name podem ser usados com @schedule_name.

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 ver propriedades dos agendamentos de tarefas que possuem.

Examples

A. Devolva o horário de trabalho para um trabalho específico

O exemplo seguinte devolve a informação de agendamento para um trabalho chamado BackupDatabase.

USE msdb;
GO

EXECUTE dbo.sp_help_jobschedule @job_name = N'BackupDatabase';
GO

B. Devolva o horário de trabalho para um horário específico

O exemplo seguinte devolve a informação para o horário nomeado NightlyJobs e para o trabalho nomeado RunReports.

USE msdb;
GO

EXECUTE dbo.sp_help_jobschedule
    @job_name = N'RunReports',
    @schedule_name = N'NightlyJobs';
GO

C. Devolva o horário e a descrição do horário para um horário específico

O exemplo seguinte devolve a informação para o horário nomeado NightlyJobs e para o trabalho nomeado RunReports. O conjunto de resultados devolvido inclui uma descrição do calendário.

USE msdb;
GO

EXECUTE dbo.sp_help_jobschedule
    @job_name = N'RunReports',
    @schedule_name = N'NightlyJobs',
    @include_description = 1;
GO

Conteúdo relacionado

  • Last updated on