sp_add_jobschedule (Transact-SQL)

Artículo
12/15/2008

Actualizado: 17 de noviembre de 2008

Crea una programación para un trabajo.

Sintaxis

sp_add_jobschedule [ @job_id = ] job_id, | [ @job_name = ] 'job_name', [ @name = ] 'name'
     [ , [ @enabled = ] enabled_flag ]
     [ , [ @freq_type = ] frequency_type ]
     [ , [ @freq_interval = ] frequency_interval ]
     [ , [ @freq_subday_type = ] frequency_subday_type ]
     [ , [ @freq_subday_interval = ] frequency_subday_interval ]
     [ , [ @freq_relative_interval = ] frequency_relative_interval ]
     [ , [ @freq_recurrence_factor = ] frequency_recurrence_factor ]
     [ , [ @active_start_date = ] active_start_date ]
     [ , [ @active_end_date = ] active_end_date ]
     [ , [ @active_start_time = ] active_start_time ]
     [ , [ @active_end_time = ] active_end_time ]
     [ , [ @schedule_id = ] schedule_id OUTPUT ]

Argumentos

[ @job_id= ] job_id
Número de identificación del trabajo al que se va a agregar la programación. job_id es de tipo uniqueidentifier y no tiene ningún valor predeterminado.

[ @job_name= ] 'job_name'
Nombre del trabajo al que se va a agregar la programación. job_name es de tipo nvarchar(128) y no tiene ningún valor predeterminado.

[!NOTA] Se debe especificar job_id o job_name, pero no ambos.

[ @name= ] 'name'
Nombre de la programación. name es de tipo nvarchar(128) y no tiene ningún valor predeterminado.

[ @enabled= ] enabled_flag
Indica el estado actual de la programación. enabled_flag es de tipo tinyint y su valor predeterminado es 1 (habilitado). Si el valor es 0, la programación no está habilitada. Si la programación está deshabilitada, el trabajo no se ejecutará.

[ @freq_type= ] frequency_type
Valor que indica cuándo va a ejecutarse el trabajo. frequency_type es de tipo int, su valor predeterminado es 0 y puede tener uno de los valores siguientes:

Valor	Descripción
1	Una vez
4	Diariamente
8	Semanalmente
16	Mensualmente
32	Mensualmente, con relación a frequency_interval.
64	Se ejecuta cuando se inicia el servicio del Agente SQL Server.
128	Se ejecuta cuando el equipo está inactivo.

[ @freq_interval= ] frequency_interval
Día en el que se ejecuta un trabajo. frequency_interval es de tipo int, su valor predeterminado es 0 y depende del valor de frequency_type como se indica en la tabla siguiente.

Valor	Efecto
1 (una vez)	frequency_interval no se utiliza.
4 (diariamente)	Cada frequency_interval días.
8 (semanalmente)	frequency_interval es uno o más de los siguientes (combinados con un operador lógico OR): 1 = Domingo 2 = Lunes 4 = Martes 8 = Miércoles 16 = Jueves 32 = Viernes 64 = Sábado
16 (mensualmente)	En el día frequency_interval del mes.
32 (relativo mensual)	frequency_interval es uno de los siguientes: 1 = Domingo 2 = Lunes 3 = Martes 4 = Miércoles 5 = Jueves 6 = Viernes 7 = Sábado 8 = Día 9 = Día de la semana 10 = Día del fin de semana
64 (cuando se inicia el servicio del Agente SQL Server)	frequency_interval no se utiliza.
128	frequency_interval no se utiliza.

[ @freq_subday_type= ] frequency_subday_type
Especifica las unidades de frequency_subday_interval. frequency_subday_type es de tipo int, no tiene ningún valor predeterminado y puede tener uno de los siguientes valores:

Valor Descripción (unidad)

0x1

A la hora especificada

0x4

Minutos

0x8

Horas

Valor	Descripción (unidad)
0x1	A la hora especificada
0x4	Minutos
0x8	Horas

[ @freq_subday_interval= ] frequency_subday_interval
Número de períodos de frequency_subday_type que transcurren entre cada ejecución de un trabajo. frequency_subday_interval es de tipo int y su valor predeterminado es 0.

[ @freq_relative_interval= ] frequency_relative_interval
Define más frequency_interval cuando frequency_type está establecido en 32 (relativo mensual).

frequency_relative_interval es de tipo int, no tiene ningún valor predeterminado y puede tener uno de los siguientes valores:

Valor Descripción (unidad)

1

Primero

2

Segundo

4

Tercero

8

Cuarto

16

Último

frequency_relative_interval indica la repetición del intervalo. Por ejemplo, si frequency_relative_interval está establecido en 2, frequency_type está establecido en 32 y frequency_interval está establecido en 3, el trabajo programado se produciría el segundo martes de cada mes.

Valor	Descripción (unidad)
1	Primero
2	Segundo
4	Tercero
8	Cuarto
16	Último

[ @freq_recurrence_factor= ] frequency_recurrence_factor
Número de semanas o meses entre la ejecución programada de un trabajo. frequency_recurrence_factor sólo se utiliza si frequency_type es 8, 16 o 32. frequency_recurrence_factor es de tipo int y su valor predeterminado es 0.

[ @active_start_date= ] active_start_date
Fecha en la que puede comenzar la ejecución de un trabajo. active_start_date es de tipo int y no tiene ningún valor predeterminado. La fecha tiene el formato AAAAMMDD. Si active_start_date está establecido, la fecha tiene que ser posterior o igual a 19900101.

Después de crear la programación, revise la fecha de inicio y confirme que es la fecha correcta que desea. Para obtener más información, vea la sección sobre cómo programar la fecha de inicio en Crear programaciones.

[ @active_end_date= ] active_end_date
Fecha en la que puede terminar la ejecución de un trabajo. active_end_date es de tipo int y no tiene ningún valor predeterminado. La fecha tiene el formato AAAAMMDD.

[ @active_start_time= ] active_start_time
Hora de un día entre active_start_date y active_end_date en que empieza la ejecución del trabajo. active_start_time es de tipo int y no tiene ningún valor predeterminado. La hora tiene el formato HHMMSS en un reloj de 24 horas.

[ **@active_end_time=**active_end_time
Hora de un día entre active_start_date y active_end_date en que termina la ejecución del trabajo. active_end_time es de tipo int y no tiene ningún valor predeterminado. La hora tiene el formato HHMMSS en un reloj de 24 horas.

[ @schedule_id=schedule_idOUTPUT
Número de identificación asignado a la programación si se ha creado correctamente. schedule_id es una variable de salida de tipo int y no tiene ningún valor predeterminado.

Conjuntos de resultados

Ninguno

Notas

Ahora, las programaciones de trabajos se pueden administrar independientemente de los trabajos. Si desea agregar una programación a un trabajo, utilice sp_add_schedule para crear la programación y sp_attach_schedule para adjuntar la programación a un trabajo.

Permisos

De forma predeterminada, los miembros de la función fija de servidor sysadmin pueden ejecutar este procedimiento almacenado. 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 más información acerca de los permisos de estas funciones, vea Funciones fijas de base de datos del Agente SQL Server.

Valores de código de retorno

0 (correcto) o 1 (error)

Vea también

Historial de cambios

Versión	Historial
17 de noviembre de 2008	Contenido modificado: Se agregó información sobre @active_start_date.

Compartir a través de

sp_add_jobschedule (Transact-SQL)

Sintaxis

Argumentos

Conjuntos de resultados

Notas

Permisos

Valores de código de retorno

Vea también

Referencia

Otros recursos

Ayuda e información

Historial de cambios

Recursos adicionales