Compartir a través de


sp_add_jobschedule (Transact-SQL)

Crea una programación para un trabajo.

Icono de vínculo a temasConvenciones de sintaxis de 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

    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.