sp_help_jobschedule (Transact-SQL)

Se aplica a:SQL Server

Devuelve información sobre la programación de trabajos utilizados por SQL Server Management Studio para realizar actividades automatizadas.

Convenciones de sintaxis de Transact-SQL

Sintaxis

  
sp_help_jobschedule { [ @job_id = ] job_id | [ @job_name = ] 'job_name' }  
     [ , [ @schedule_name = ] 'schedule_name' ]  
     [ , [ @schedule_id = ] schedule_id ]  
     [ , [ @include_description = ] include_description ]  

Argumentos

[ @job_id = ] job_id Número de identificación del trabajo. job_ides uniqueidentifier, con un valor predeterminado de NULL.

[ @job_name = ] 'job_name' Nombre del trabajo. job_namees sysname, con un valor predeterminado de NULL.

Nota

Se deben especificar job_id o job_name , pero no se pueden especificar ambos.

[ @schedule_name = ] 'schedule_name' Nombre del elemento de programación del trabajo. schedule_namees sysname, con un valor predeterminado de NULL.

[ @schedule_id = ] schedule_id Número de identificación del elemento de programación del trabajo. schedule_ides int, con un valor predeterminado de NULL.

[ @include_description = ] include_description Especifica si se debe incluir la descripción de la programación en el conjunto de resultados. include_description es bit, con un valor predeterminado de 0. Cuando include_description es 0, la descripción de la programación no se incluye en el conjunto de resultados. 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

Nombre de la columna	Tipo de datos	Descripción
schedule_id	int	Número de 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 en inglés de la programación derivada de valores en msdb.dbo.sysschedules. Cuando include_description es 0, esta columna contiene texto que indica que no se solicitó la descripción.
next_run_date	int	Fecha en que la programación hará que se vuelva a ejecutar el trabajo.
next_run_time	int	Hora a la que la programación hará que se vuelva a ejecutar el trabajo.
schedule_uid	uniqueidentifier	Identificador de la programación.
job_count	int	Recuento de trabajos devueltos.

Nota

sp_help_jobschedule** devuelve valores de las tablas del sistema dbo.sysjobschedules y dbo.sysschedules en msdb. sysjobschedules se actualiza cada 20 minutos. Esto puede afectar a los valores devueltos por este procedimiento almacenado.

Comentarios

Los parámetros de sp_help_jobschedule solo se pueden usar en determinadas combinaciones. Si se especifica schedule_id , no se pueden especificar job_id ni job_name . De lo contrario, los parámetros job_id o job_name se pueden usar con schedule_name.

Permisos

Requiere la pertenencia al rol fijo de servidor sysadmin . 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 propiedades de las programaciones de trabajo que poseen.

Ejemplos

A. Devolver la programación de un trabajo específico

En el ejemplo siguiente se devuelve información de la programación de un trabajo denominado BackupDatabase.

USE msdb ;  
GO  
  
EXEC dbo.sp_help_jobschedule  
    @job_name = N'BackupDatabase' ;  
GO  

B. Devolver la programación de un trabajo para una programación específica

En el ejemplo siguiente se devuelve información de la programación denominada NightlyJobs y el trabajo denominado RunReports.

USE msdb ;  
GO  
  
EXEC dbo.sp_help_jobschedule   
    @job_name = N'RunReports',  
    @schedule_name = N'NightlyJobs' ;  
GO  

C. Devolver la programación de un trabajo y la descripción de una programación específica

En el ejemplo siguiente se devuelve información de la programación denominada NightlyJobs y el trabajo denominado RunReports. El conjunto de resultados devuelto incluye una descripción de la programación.

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

Consulte también

sp_add_schedule (Transact-SQL)
sp_delete_schedule (Transact-SQL)
sp_update_schedule (Transact-SQL)
Procedimientos almacenados del sistema (Transact-SQL)