sp_add_jobschedule (Transact-SQL)

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	Primera
  2	Segunda
  4	Tercera
  8	Cuarta
  16	Última

  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 solo 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

Comentarios

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

Vea también

Tasks

Referencia

Conceptos