En SQL Server, el sp_help_schedule El procedimiento almacenado devuelve información sobre programaciones en el Agente SQL Server.
Este artículo proporciona una descripción general de este procedimiento almacenado, incluidos ejemplos.
Sintaxis
La sintaxis oficial es así:
sp_help_schedule
[ @schedule_id = ] id ,
[ @schedule_name = ] 'schedule_name'
[ , [ @attached_schedules_only = ] attached_schedules_only ]
[ , [ @include_description = ] include_description ]
Puede llamar a sp_help_schedule , con o sin parámetros.
Cuando lo llama sin ningún parámetro, devuelve una lista de todos los horarios en la instancia.
Cuando pasa un nombre de horario o ID, devuelve solo ese horario.
Tenga en cuenta que sp_help_schedule está en el msdb base de datos, por lo que debe ejecutarse desde allí. Puede hacerlo cambiando a msdb base de datos (por ejemplo, con USE msdb ), o calificando el procedimiento con el nombre y el esquema de la base de datos (es decir, msdb.dbo.sp_help_schedule ).
Ejemplo
Aquí hay un ejemplo para demostrar cómo devolver todos los horarios en la instancia:
EXEC msdb.dbo.sp_help_schedule;Resultado:
Devolver un horario basado en su nombre
También puede obtener un horario basado en su nombre:
EXEC msdb.dbo.sp_help_schedule
@schedule_name = 'Weekly_Sun_3AM';Devolver un horario basado en su ID
Alternativamente, puede obtener un horario basado en su ID:
EXEC msdb.dbo.sp_help_schedule
@schedule_id = 14;Devolver solo los horarios adjuntos
Aunque sp_help_schedule no devuelve horarios para un trabajo específico (use sp_help_jobschedule para eso), puede usarlo para devolver solo los horarios que están adjuntos a un trabajo.
Puede hacer esto con @attached_schedules_only parámetro.
El @attached_schedules_only el parámetro es bit , con un valor predeterminado de 0 , lo que significa que devuelve horarios adjuntos y no adjuntos. Pasando un valor de 1 lo limita a los horarios adjuntos.
Ejemplo:
EXEC sp_help_schedule
@attached_schedules_only = 1;Incluya la Descripción
Otra cosa que puedes hacer es especificar si incluir o no la descripción del horario.
De forma predeterminada, la descripción no se incluye en el conjunto de resultados. En realidad, el schedule_description columna es incluido, pero no contiene la descripción, a menos que usted lo solicite explícitamente. Si no lo solicita, el schedule_description la columna muestra (Description not requested.) .
El @include_description el parámetro es bit , con un valor predeterminado de 0 , lo que significa que no muestra la descripción. Pasando un valor de 1 hace que se muestre la descripción.
EXEC sp_help_jobschedule
@job_name = 'SqlAgentTest',
@include_description = 1;
