sp_changesubscriber_schedule (Transact-SQL)

Изменяет расписание агента распространителя или агента слияния для подписчика. Эта хранимая процедура выполняется на подписчике в любой базе данных.

Значок ссылки на разделСинтаксические обозначения в Transact-SQL

Синтаксис

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' ]

Аргументы

  • [ @subscriber=] 'subscriber'
    Имя подписчика. Аргумент subscriber имеет тип sysname. Имя подписчика должно быть уникальным в базе данных, не должно использоваться до этого и не может иметь значения NULL.

  • [ @agent_type=] type
    Тип агента. Аргумент type имеет тип smallint и значение 0 по умолчанию. Значение 0 указывает на агент распространителя. Значение 1 указывает на агент слияния.

  • [ @frequency_type=] frequency_type
    Частота, с которой необходимо планировать задачу распространения. Аргумент frequency_type имеет тип int и значение 64 по умолчанию. Существует 10 столбцов расписания.

  • [ @frequency_interval=] frequency_interval
    Значение, применяемое для частоты, устанавливаемой аргументом frequency_type. Аргумент frequency_interval имеет тип int и значение по умолчанию 1.

  • [ @frequency_relative_interval=] frequency_relative_interval
    Дата для задачи распространения. Аргумент frequency_relative_interval имеет тип int и значение по умолчанию 1.

  • [ @frequency_recurrence_factor=] frequency_recurrence_factor
    Коэффициент рекурсии, используемый аргументом frequency_type. Аргумент frequency_recurrence_factor имеет тип int и значение по умолчанию 0.

  • [ @frequency_subday=] frequency_subday
    Как часто, в минутах, производится изменение расписания в течение указанного периода. Аргумент frequency_subday имеет тип int и значение по умолчанию 4.

  • [ @frequency_subday_interval=] frequency_subday_interval
    Интервал для значения frequency_subday. Аргумент frequency_subday_interval имеет тип int и значение по умолчанию 5.

  • [ @active_start_time_of_day=] active_start_time_of_day
    Время, когда первый раз был запланирован запуск задачи распространения. Аргумент active_start_time_of_day имеет тип int и значение по умолчанию 0.

  • [ @active_end_time_of_day=] active_end_time_of_day
    Время, когда прекращается выполнение задачи распространения по расписанию. Аргумент active_end_time_of_day имеет тип int и значение по умолчанию 235959, что означает 23:59:59.

  • [ @active_start_date=] active_start_date
    Дата, на которую запланировано первое выполнение задачи распространения, в формате ГГГГММДД. Аргумент active_start_date имеет тип int и значение по умолчанию 0.

  • [ @active_end_date=] active_end_date
    Дата прекращения выполнения задачи распространения по расписанию, в формате ГГГГММДД. Аргумент active_end_date имеет тип int и значение по умолчанию 99991231, что означает 31 декабря 9999г.

  • [ @publisher= ] 'publisher'
    Указывает издателя, не являющегося издателем Microsoft SQL Server. Аргумент publisher имеет тип sysname и значение по умолчанию NULL.

    ПримечаниеПримечание

    Аргумент publisher не следует использовать при изменении свойств статьи на издателе SQL Server.

Значения кодов возврата

0 (успешное завершение) или 1 (неуспешное завершение)

Замечания

Хранимая процедура sp_changesubscriber_schedule используется во всех типах репликации.

Разрешения

Только члены предопределенной роли сервера sysadmin могут выполнять процедуру sp_changesubscriber_schedule.