sp_add_jobschedule (Transact-SQL)
Crea una programación para un trabajo.
.gif "Icono de vínculo a temas")
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
[ @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.
[ @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.Una vez creada la programación, revise la fecha de inicio y confirme que es correcta. Para obtener más información, vea la sección "Programar fechas de inicio" de Crear y adjuntar programaciones a trabajos.
[ @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.[ @schedule_uid= ] schedule_uidOUTPUT
Es un identificador único para la programación. schedule_uid es una variable de tipo uniqueidentifier.
Valores de código de retorno
0 (correcto) o 1 (error)
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.
Historial de cambios
Contenido actualizado |
|---|
El parámetro de fecha de inicio incluye información sobre cómo confirmar la fecha de inicio una vez creada una programación. |
Vea también