sp_changesubscriber_schedule (Transact-SQL)

Cambia la programación del Agente de distribución o del Agente de mezcla para un suscriptor. Este procedimiento almacenado se ejecuta en el publicador de cualquier base de datos.

Icono de vínculo a temasConvenciones de sintaxis de Transact-SQL

Sintaxis

sp_changesubscriber_schedule [ @subscriber = ] 'subscriber', [ @agent_type = ] type
    [ , [ @frequency_type = ] frequency_type ]
    [ , [ @frequency_interval = ] frequency_interval ]
    [ , [ @frequency_relative_interval = ] frequency_relative_interval ]
    [ , [ @frequency_recurrence_factor = ] frequency_recurrence_factor ]
    [ , [ @frequency_subday = ] frequency_subday ]
    [ , [ @frequency_subday_interval = ] frequency_subday_interval ]
    [ , [ @active_start_time_of_day = ] active_start_time_of_day ]
    [ , [ @active_end_time_of_day = ] active_end_time_of_day ]
    [ , [ @active_start_date = ] active_start_date ]
    [ , [ @active_end_date = ] active_end_date ]
    [ , [ @publisher = ] 'publisher' ]

Argumentos

  • [ @subscriber=] 'subscriber'
    Es el nombre del suscriptor. subscriber es de tipo sysname. El nombre del suscriptor tiene que ser único en la base de datos, no puede existir previamente y no puede ser NULL.

  • [ @agent_type=] type
    Es el tipo de agente. type es de tipo smallint y su valor predeterminado es 0. 0 indica que es un Agente de distribución. 1 indica que es un Agente de mezcla.

  • [ @frequency_type=] frequency_type
    Es la frecuencia con la que se desea programar la tarea de distribución. frequency_type es de tipo int y su valor predeterminado es 64. Hay 10 columnas de programación.

  • [ @frequency_interval=] frequency_interval
    Es el valor aplicado a la frecuencia establecida por frequency_type. frequency_interval es de tipo int y su valor predeterminado es 1.

  • [ @frequency_relative_interval=] frequency_relative_interval
    Es la fecha de la tarea de distribución. frequency_relative_interval es de tipo int y su valor predeterminado es 1.

  • [ @frequency_recurrence_factor=] frequency_recurrence_factor
    Es el factor de periodicidad utilizado por frequency_type. frequency_recurrence_factor es de tipo int y su valor predeterminado es 0.

  • [ @frequency_subday=] frequency_subday
    Es la frecuencia, en minutos, con la que se debe repetir la programación durante el periodo definido. frequency_subday es de tipo int y su valor predeterminado es 4.

  • [ @frequency_subday_interval=] frequency_subday_interval
    Es el intervalo de frequency_subday. frequency_subday_interval es de tipo int y su valor predeterminado es 5.

  • [ @active_start_time_of_day=] active_start_time_of_day
    Es la hora del día para la que la tarea de distribución se programa por primera vez. active_start_time_of_day es de tipo int y su valor predeterminado es 0.

  • [ @active_end_time_of_day=] active_end_time_of_day
    Es la hora del día en la que deja de programarse la tarea de distribución. active_end_time_of_day es de tipo int y su valor predeterminado es 235959, que significa 11:59:59 p. m. en un reloj de 24 horas.

  • [ @active_start_date=] active_start_date
    Es la fecha en la que comienza la programación de la tarea de distribución, en formato YYYYMMDD. active_start_date es de tipo int y su valor predeterminado es 0.

  • [ @active_end_date=] active_end_date
    Es la fecha en la que se detiene la programación de la tarea de distribución, en formato YYYYMMDD. active_end_date es de tipo int y su valor predeterminado es 99991231, que significa 31 de diciembre de 9999.

  • [ @publisher= ] 'publisher'
    Especifica un publicador que no es de Microsoft SQL Server. publisher es de tipo sysname y su valor predeterminado es NULL.

    Nota

    publisher no debería utilizarse cuando se cambian las propiedades del artículo de un publicador de SQL Server.

Valores de código de retorno

0 (correcto) o 1 (error)

Comentarios

sp_changesubscriber_schedule se utiliza en todos los tipos de replicación.

Permisos

Sólo los miembros de la función fija de servidor sysadmin pueden ejecutar sp_changesubscriber_schedule.