sp_changesubscriber_schedule (Transact-SQL)

  • Статья

Область применения: SQL Server Управляемый экземпляр SQL Azure

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

Соглашения о синтаксисе Transact-SQL

Синтаксис

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

Аргументы

[ @subscriber = ] N'подписчик'

Имя подписчика. @subscriber — sysname без значения по умолчанию. Имя подписчика должно быть уникальным в базе данных, не должно существовать и не может быть NULL.

[ @agent_type = ] agent_type

Тип агента. @agent_type имеет небольшой размер с значением по умолчанию0.

  • 0указывает агент распространения.
  • 1указывает агент слияния.

[ @frequency_type = ] frequency_type

Указывает частоту планирования задачи распространения. @frequency_type является int и может быть одним из этих значений.

значение Описание
1 Один раз.
2 по запросу
4 Ежедневно
8 Weekly (Еженедельно);
16 Ежемесячная
32 Ежемесячно с относительной датой
64 (по умолчанию) Автозапуск
128 Повторяющееся задание

[ @frequency_interval = ] frequency_interval

Значение, применяемое к частоте, заданной @frequency_type. @frequency_interval является int и зависит от значения @frequency_type.

Значение @frequency_type Влияние на @frequency_interval
1 (по умолчанию) @frequency_interval не используется.
4 Каждые @frequency_interval дней.
8 @frequency_interval является одним или несколькими из следующих (в сочетании с | (битовое ИЛИ) логический оператор):

1 = воскресенье
2 = понедельник
4 = вторник
8 = среда
16 = четверг
32 = пятница
64 = суббота
16 На @frequency_interval день месяца.
32 @frequency_interval является одним из следующих вариантов:

1 = воскресенье
2 = понедельник
3 = вторник
4 = среда
5 = четверг
6 = пятница
7 = суббота
8 = день
9 = еженедельный день
10 = выходные дни
64 @frequency_interval не используется.
128 @frequency_interval не используется.

[ @frequency_relative_interval = ] frequency_relative_interval

Дата задачи распространения. @frequency_relative_interval является int и может быть одним из этих значений.

значение Описание
1 (по умолчанию) First
2 Second
4 Третья
8 Четвертая
16 Last

[ @frequency_recurrence_factor = ] frequency_recurrence_factor

Коэффициент повторения, используемый @frequency_type. @frequency_recurrence_factor имеет значение int с значением по умолчанию0.

[ @frequency_subday = ] frequency_subday

Указывает частоту перепланирований в минутах в течение определенного периода. @frequency_subday является int и может быть одним из этих значений.

значение Описание
1 Однократно
2 Second
4 (по умолчанию) Minute
8 Часы

[ @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 с значением по умолчаниюNULL.

[ @active_end_time_of_day = ] active_end_time_of_day

Время дня, когда задача распространения перестает планироваться. @active_end_time_of_day является int, с значением по умолчанию235959, что означает 11:59:59 вечера на 24-часовые часы.

[ @active_start_date = ] active_start_date

Дата, когда задача распространителя впервые запланирована, отформатирована как yyyyMMdd. @active_start_date имеет значение int с значением по умолчаниюNULL.

[ @active_end_date = ] active_end_date

Дата, когда задача распространителя перестает планироваться, отформатирована как yyyyMMdd. @active_end_date является int, с значением по умолчанию99991231, что означает 31 декабря 9999 года.

[ @publisher = ] N'publisher'

Указывает издатель, отличный от SQL Server. @publisher — sysname с значением по умолчаниюNULL.

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

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

0 (успешно) или 1 (сбой).

Замечания

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

Разрешения

Могут выполняться sp_changesubscriber_scheduleтолько члены предопределенных ролей сервера sysadmin.

Связанный контент