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.
.gif "Icono de vínculo a temas")
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 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.
Valores de código de retorno
0 (correcto) o 1 (error)
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) |
Descripción en inglés de la programación que se deriva 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 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 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
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 obtener detalles sobre los permisos de estos roles, vea Roles fijos de base de datos del Agente SQL Server.
Los miembros de SQLAgentUserRole solo pueden ver las propiedades de las programaciones de los trabajos que les pertenecen.
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)