Compartir a través de

sp_help_schedule (Transact-SQL)

  • Artículo

Se aplica a: SQL Server

Muestra información acerca de programaciones.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_help_schedule
    [ [ @schedule_id = ] schedule_id ]
    [ , [ @schedule_name = ] N'schedule_name' ]
    [ , [ @attached_schedules_only = ] attached_schedules_only ]
    [ , [ @include_description = ] include_description ]
[ ; ]

Argumentos

[ @schedule_id = ] schedule_id

Identificador de la programación que se va a mostrar. @schedule_id es int, con un valor predeterminado de NULL.

Se pueden especificar @schedule_id o @schedule_name .

[ @schedule_name = ] N'schedule_name'

Nombre de la programación que se va a mostrar. @schedule_name es sysname, con un valor predeterminado de NULL.

Se pueden especificar @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 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 incluyen 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 (erróneo).

Conjunto 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 freq_interval
64 = Ejecute cuando se inicie el servicio SQLServerAgent.
freq_interval int Días en los que se ejecuta el trabajo. El valor depende del valor de freq_type. Para obtener más información, consulte sp_add_schedule.
freq_subday_type int Unidades para freq_subday_interval. Para obtener más información, consulte sp_add_schedule.
freq_subday_interval int Número de freq_subday_type períodos que se van a producir entre cada ejecución del trabajo. Para obtener más información, consulte sp_add_schedule.
freq_relative_interval int La aparición del trabajo programado de freq_interval en cada mes. Para obtener más información, consulte sp_add_schedule.
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 se muestra información de todas las programaciones de la instancia.

Permisos

Puede conceder EXECUTE permisos en este procedimiento, pero estos permisos se pueden invalidar durante una actualización de SQL Server.

A otros usuarios se les debe conceder uno de los siguientes Agente SQL Server roles fijos de base de datos en la msdb base de datos:

  • 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 Enumeración de la 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. Enumeración de la 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

Contenido relacionado