Compartir vía

sp_changesubscriber_schedule (Transact-SQL)

  • Artículo

Se aplica a: SQL Server Azure SQL Managed Instance

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.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_changesubscriber_schedule
    [ @subscriber = ] N'subscriber'
    , [ @agent_type = ] agent_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 = ] N'publisher' ]
[ ; ]

Argumentos

[ @subscriber = ] N'subscriber'

Nombre del suscriptor. @subscriber es sysname, sin ningún valor predeterminado. El nombre del suscriptor debe ser único en la base de datos, no debe existir y no puede ser NULL.

[ @agent_type = ] agent_type

Tipo de agente. @agent_type es smallint, con un valor predeterminado de 0.

  • 0indica un Agente de distribución.
  • 1indica un Agente de mezcla.

[ @frequency_type = ] frequency_type

Especifica la frecuencia con la que programar la tarea de distribución. @frequency_type es int y puede ser uno de estos valores.

Valor Descripción
1 Una vez
2 A petición
4 Diario
8 Semanal
16 Mensual
32 Mensualmente relativa
64 (valor predeterminado) Iniciar automáticamente
128 Periódico

[ @frequency_interval = ] frequency_interval

Valor aplicado a la frecuencia establecida por @frequency_type. @frequency_interval es int y depende del valor de @frequency_type.

Valor de @frequency_type Efecto en @frequency_interval
1 (valor predeterminado) @frequency_interval no se usa.
4 Cada @frequency_interval días.
8 @frequency_interval es una o varias de las siguientes (combinadas con | (OR bit a bit) operador lógico):

1 = Domingo
2 = Lunes
4 = Martes
8 = miércoles
16 = Jueves
32 = Viernes
64 = Sábado
16 En el @frequency_interval día del mes.
32 @frequency_interval es una de las siguientes opciones:

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 @frequency_interval no se usa.
128 @frequency_interval no se usa.

[ @frequency_relative_interval = ] frequency_relative_interval

Fecha de la tarea de distribución. @frequency_relative_interval es int y puede ser uno de estos valores.

Valor Descripción
1 (valor predeterminado) Primero
2 Segundo
4 Tercero
8 Cuarta
16 Último

[ @frequency_recurrence_factor = ] frequency_recurrence_factor

Factor de periodicidad utilizado por @frequency_type. @frequency_recurrence_factor es int, con un valor predeterminado de 0.

[ @frequency_subday = ] frequency_subday

Especifica la frecuencia, en minutos, para volver a programar durante el período definido. @frequency_subday es int y puede ser uno de estos valores.

Valor Descripción
1 Una vez
2 Second
4 (valor predeterminado) Minute
8 Hora

[ @frequency_subday_interval = ] frequency_subday_interval

Número de frequency_subday períodos que se producen entre cada ejecución del trabajo. @frequency_subday_interval es int, con un valor predeterminado de 5.

[ @active_start_time_of_day = ] active_start_time_of_day

Hora del día en que la tarea de distribución se programa por primera vez. @active_start_time_of_day es int, con un valor predeterminado de NULL.

[ @active_end_time_of_day = ] active_end_time_of_day

Hora del día en que la tarea de distribución deja de programarse. @active_end_time_of_day es int, con un valor predeterminado de 235959, lo que significa 11:59:59 p.m. en un reloj de 24 horas.

[ @active_start_date = ] active_start_date

Fecha en que la tarea de distribución está programada por primera vez, con formato .yyyyMMdd @active_start_date es int, con un valor predeterminado de NULL.

[ @active_end_date = ] active_end_date

Fecha en la que la tarea de distribución deja de programarse, con el formato yyyyMMdd. @active_end_date es int, con un valor predeterminado de , lo que significa el 31 de 99991231diciembre de 9999.

[ @publisher = ] N'publisher'

Especifica un publicador que no es de SQL Server. @publisher es sysname, con un valor predeterminado de NULL.

@publisher no se debe usar al cambiar las propiedades del artículo en un publicador de SQL Server.

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Comentarios

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

Permisos

Solo los miembros del rol fijo de servidor sysadmin pueden ejecutar sp_changesubscriber_schedule.

Contenido relacionado