sp_help_schedule (Transact-SQL)

Se aplica a:SQL Server

Muestra información acerca de programaciones.

Convenciones de sintaxis de Transact-SQL

Sintaxis

  
sp_help_schedule   
     [ @schedule_id = ] id ,  
     [ @schedule_name = ] 'schedule_name'   
     [ , [ @attached_schedules_only = ] attached_schedules_only ]  
     [ , [ @include_description = ] include_description ]  

Argumentos

[ @schedule_id = ] id Identificador de la programación que se va a enumerar. schedule_name es int, sin ningún valor predeterminado. Se pueden especificar schedule_id o schedule_name .

[ @schedule_name = ] 'schedule_name' Nombre de la programación que se va a enumerar. schedule_name es sysname, sin ningún valor predeterminado. Se pueden especificar schedule_id o schedule_name .

[ @attached_schedules_only = ] attached_schedules_only ] Especifica si solo se muestran las programaciones a las que está asociado un trabajo. attached_schedules_only es bit, con un valor predeterminado de 0. Cuando attached_schedules_only es 0, se muestran todas las programaciones. Cuando attached_schedules_only es 1, el conjunto de resultados solo contiene programaciones asociadas a un trabajo.

[ @include_description = ] include_description Especifica si se deben incluir descripciones en el conjunto de resultados. include_description es bit, con un valor predeterminado de 0. Cuando include_description es 0, la columna schedule_description del conjunto de resultados contiene un marcador de posición. Cuando include_description es 1, la descripción de la programación se incluye en el conjunto de resultados.

Valores de código de retorno

0 (correcto) o 1 (error)

Conjuntos de resultados

Este procedimiento devuelve el siguiente conjunto de resultados:

Nombre de la columna	Tipo de datos	Descripción
schedule_id	int	Número de identificador de la programación.
schedule_uid	uniqueidentifier	Identificador de la programación.
schedule_name	sysname	Nombre de la programación.
enabled	int	Indica si la programación está habilitada (1) o no (0).
freq_type	int	Valor que indica cuándo se va a ejecutar el trabajo. 1 = Una vez 4 = Diario 8 = Semanal 16 = Mensual 32 = Mensual, en relación con el freq_interval 64 = Ejecutar cuando se inicia el servicio SQLServerAgent.
freq_interval	int	Días en los que se ejecuta el trabajo. El valor depende del valor de freq_type. Para más información, consulte sp_add_schedule (Transact-SQL).
freq_subday_type	int	Unidades para freq_subday_interval. Para más información, consulte sp_add_schedule (Transact-SQL).
freq_subday_interval	int	Número de períodos de freq_subday_type que se van a producir entre cada ejecución del trabajo. Para más información, consulte sp_add_schedule (Transact-SQL).
freq_relative_interval	int	La aparición del trabajo programado del freq_interval en cada mes. Para más información, consulte sp_add_schedule (Transact-SQL).
freq_recurrence_factor	int	Número de meses entre las ejecuciones programadas del trabajo.
active_start_date	int	Fecha en que se activó la programación.
active_end_date	int	Fecha final de la programación.
active_start_time	int	Hora del día en que se inicia la programación.
active_end_time	int	Hora del día en que termina la programación.
date_created	datetime	Fecha en que se creó la programación.
schedule_description	nvarchar(4000)	Descripción de la programación en inglés (si se solicita).
job_count	int	Devuelve el número de trabajos que hacen referencia a esta programación.

Comentarios

Cuando no se proporcionan parámetros, sp_help_schedule enumera la información de todas las programaciones de la instancia.

Permisos

De forma predeterminada, los miembros del rol fijo de servidor sysadmin pueden ejecutar este procedimiento almacenado. Al resto de usuarios se les debe conceder uno de los siguientes roles fijos de base de datos del Agente SQL Server en la base de datos msdb :

• SQLAgentUserRole

• SQLAgentReaderRole

• SQLAgentOperatorRole

Para detalles sobre los permisos de estos roles, consulte Roles fijos de base de datos del Agente SQL Server.

Los miembros de SQLAgentUserRole solo pueden ver las programaciones que poseen.

Ejemplos

A. Mostrar información de todas las programaciones de la instancia

El ejemplo siguiente muestra información de todas las programaciones de la instancia.

USE msdb ;  
GO  
  
EXEC dbo.sp_help_schedule ;  
GO  

B. Mostrar información de una programación específica

El ejemplo siguiente muestra información de la programación denominada NightlyJobs.

USE msdb ;  
GO  
  
EXEC dbo.sp_help_schedule  
    @schedule_name = N'NightlyJobs' ;  
GO  

Consulte también

sp_add_schedule (Transact-SQL)
sp_attach_schedule (Transact-SQL)
sp_delete_schedule (Transact-SQL)
sp_detach_schedule (Transact-SQL)