sp_help_jobschedule (Transact-SQL)
Devuelve información acerca de la programación de los trabajos que SQL Server Management Studio utiliza para realizar actividades automatizadas.
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 de tipo uniqueidentifier y su valor predeterminado es NULL.
[ @job_name= ] 'job_name'
Nombre del trabajo. job_namees de tipo sysname y su valor predeterminado es NULL.[!NOTA] Se debe especificar job_id o job_name, pero no ambos.
- [ @schedule_name= ] 'schedule_name'
Nombre del elemento de programación del trabajo. schedule_namees de tipo sysname y su valor predeterminado es NULL.
- [ @schedule_id= ] schedule_id
Número de identificación del elemento de programación del trabajo. schedule_ides de tipo int y su valor predeterminado es NULL.
- [ @include_description= ] include_description
Especifica si se va a incluir la descripción de la programación en el conjunto de resultados. include_description es de tipo bit y su valor predeterminado es 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, se incluye la descripción de la programación en el conjunto de resultados.
Conjuntos de resultados
| Nombre de 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 deshabilitada (0). |
freq_type |
int |
Valor que indica cuándo se va a ejecutar el trabajo. 1 = Una vez 4 = Diariamente 8 = Semanalmente 16 = Mensualmente 32 = Mensualmente, relativo a freq_interval 64 = Se ejecuta cuando se inicia el servicio SQLServerAgent |
freq_interval |
int |
Días en que se ejecuta el trabajo. El valor depende del valor de freq_type. Para obtener más información, vea sp_add_schedule (Transact-SQL). |
freq_subday_type |
int |
Unidades para freq_subday_interval. Para obtener más información, vea sp_add_schedule (Transact-SQL). |
freq_subday_interval |
int |
Número de períodos de freq_subday_type que deben transcurrir entre cada ejecución del trabajo. Para obtener más información, vea sp_add_schedule (Transact-SQL). |
freq_relative_interval |
int |
Repeticiones del freq_interval del trabajo programado cada mes. Para obtener más información, vea 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) |
Una descripción en inglés de la programación procedente de los valores de 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 los valores de las tablas del sistema de dbo.sysschedules y dbo.sysjobschedules en msdb. Cada 20 minutos se actualiza sysjobschedules. Esto puede afectar a los valores que devuelve este procedimiento almacenado.
Notas
Los parámetros de sp_help_jobschedule sólo se pueden utilizar en algunas combinaciones. Si se especifica schedule_id, no puede especificarse ni job_id ni job_name. De lo contrario, los parámetros job_id o job_name pueden utilizarse con schedule_name.
Permisos
De manera predeterminada, este procedimiento almacenado lo pueden ejecutar los miembros de la función fija de servidor sysadmin. Al resto de usuarios se les debe conceder una de las siguientes funciones fijas de base de datos del Agente SQL Server en la base de datos msdb:
- SQLAgentUserRole
- SQLAgentReaderRole
- SQLAgentOperatorRole
Para obtener detalles sobre los permisos de estas funciones, vea Funciones fijas de base de datos del Agente SQL Server.
Los miembros de SQLAgentUserRole sólo pueden ver las propiedades de las programaciones de los trabajos que les pertenecen.
Valores de código de retorno
0 (correcto) o 1 (error)
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
Vea también
Referencia
sp_add_schedule (Transact-SQL)
sp_delete_schedule (Transact-SQL)
sp_update_schedule (Transact-SQL)
Procedimientos almacenados del sistema (Transact-SQL)