sp_help_schedule (Transact-SQL)
Muestra información acerca de programaciones.
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
Es el identificador de la programación que se va a mostrar. schedule_name es de tipo int y no tiene ningún valor predeterminado. Puede especificarse schedule_id o schedule_name.
- [ @schedule_name = ] 'schedule_name'
Es el nombre de la programación que se va a mostrar. schedule_name es de tipo sysname y no tiene ningún valor predeterminado. Puede especificarse schedule_id o schedule_name.
- [ @attached_schedules_only = ] attached_schedules_only ]
Especifica si se muestran únicamente las programaciones a las que está adjunto un trabajo. attached_schedules_only es de tipo bit y su valor predeterminado es 0. Cuando attached_schedules_only es 0, se muestran todas las programaciones. Cuando attached_schedules_only es 1, el conjunto de resultados contiene sólo las programaciones adjuntas a un trabajo.
- [ @include_description = ] include_description
Especifica si se incluyen descripciones en el conjunto de resultados. include_description es de tipo bit y su valor predeterminado es 0. Cuando include_description es 0, la columna schedule_description del conjunto de resultados contiene un marcador. Cuando include_description es 1, se incluye la descripción de la programación en el conjunto de resultados.
Conjuntos de resultados
Este procedimiento devuelve el siguiente conjunto de resultados:
| Nombre de 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 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 de la programación en inglés (si se requiere). |
job_count |
int |
Devuelve el número de trabajos que hacen referencia a esta programación. |
Notas
Si no se proporcionan parámetros, sp_help_schedule muestra información de todas las programaciones de la instancia.
Permisos
De forma predeterminada, los miembros de la función fija de servidor sysadmin pueden ejecutar este procedimiento almacenado. A otros usuarios debe concederse 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 más información acerca de 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 programaciones de las que sean propietarios.
Valores de código de retorno
0 (correcto) o 1 (error)
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
Vea también
Referencia
sp_add_schedule (Transact-SQL)
sp_attach_schedule (Transact-SQL)
sp_delete_schedule (Transact-SQL)
sp_update_schedule (Transact-SQL)