No SQL Server, o
sp_help_schedule procedimento armazenado retorna informações sobre agendamentos no SQL Server Agent. Este artigo fornece uma visão geral desse procedimento armazenado, incluindo exemplos.
Sintaxe
A sintaxe oficial é assim:
sp_help_schedule
[ @schedule_id = ] id ,
[ @schedule_name = ] 'schedule_name'
[ , [ @attached_schedules_only = ] attached_schedules_only ]
[ , [ @include_description = ] include_description ]Você pode chamar
sp_help_schedule , com ou sem parâmetros. Quando você o chama sem nenhum parâmetro, ele retorna uma lista de todos os agendamentos na instância.
Quando você passa um nome ou ID de agendamento, ele retorna apenas esse agendamento.
Observe que
sp_help_schedule está no msdb banco de dados, então ele precisa ser executado a partir daí. Você pode fazer isso alternando para o msdb banco de dados (por exemplo, com USE msdb ), ou qualificando o procedimento com o nome e o esquema do banco de dados (ou seja, msdb.dbo.sp_help_schedule ). Exemplo
Aqui está um exemplo para demonstrar como retornar todos os agendamentos na instância:
EXEC msdb.dbo.sp_help_schedule;Resultado:
Devolver uma programação com base em seu nome
Você também pode obter uma programação com base em seu nome:
EXEC msdb.dbo.sp_help_schedule
@schedule_name = 'Weekly_Sun_3AM';Devolver uma programação com base em seu ID
Você também pode obter uma programação com base em seu ID:
EXEC msdb.dbo.sp_help_schedule
@schedule_id = 14;Devolver apenas Cronogramas Anexados
Embora
sp_help_schedule não retorna agendamentos para um trabalho específico (use sp_help_jobschedule para isso), você pode usá-lo para retornar apenas os agendamentos que estão anexados a um trabalho. Você pode fazer isso com o
@attached_schedules_only parâmetro. O
@attached_schedules_only parâmetro é bit , com um padrão de 0 , o que significa que ele retorna agendas anexadas e não anexadas. Passando um valor de 1 limita-o apenas a horários anexados. Exemplo:
EXEC sp_help_schedule
@attached_schedules_only = 1;Incluir a Descrição
Outra coisa que você pode fazer é especificar se deve ou não incluir a descrição da programação.
Por padrão, a descrição não é incluída no conjunto de resultados. Na verdade, a
schedule_description coluna é incluído, mas não contém a descrição, a menos que você solicite explicitamente. Se você não solicitar, o schedule_description coluna exibe (Description not requested.) . O
@include_description parâmetro é bit , com um padrão de 0 , o que significa que não exibe a descrição. Passando um valor de 1 resulta na descrição que está sendo exibida. EXEC sp_help_jobschedule
@job_name = 'SqlAgentTest',
@include_description = 1;
