Хранимая процедура sp_addsubscriber_schedule (Transact-SQL)
Добавляет расписание агента распространителя и агента слияния. Эта хранимая процедура выполняется на подписчике в любой базе данных.
Синтаксические обозначения в Transact-SQL
Синтаксис
sp_addsubscriber_schedule [ @subscriber = ] '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 = ] 'publisher' ]
Аргументы
[ @subscriber = ] 'subscriber'
Имя подписчика. Аргумент subscriber имеет тип sysname. Имя подписчика должно быть уникальным в базе данных, не должно использоваться до этого и не может иметь значения NULL.[ @agent_type = ] agent_type
Тип агента. agent_type — это значение типа smallint, может иметь одно из указанных значений.Значение
Описание
0 (по умолчанию)
Агент распространителя
1
Агент слияния
[ @frequency_type = ] frequency_type
Частота запуска агента распространителя по расписанию. frequency_type — это значение типа int, может иметь одно из указанных значений.Значение
Описание
1
Однократно
2
По запросу
4
Ежедневно
8
Еженедельно
16
Ежемесячно
32
Ежемесячно с относительной датой
64 (по умолчанию)
Автозапуск
128
Повторяющееся задание
[ @frequency_interval = ] frequency_interval
Значение, которое применяется к частоте, задаваемой аргументом frequency_type. Аргумент frequency_interval имеет тип int и значение по умолчанию 1.[ @frequency_relative_interval = ] frequency_relative_interval
Дата агента распространителя. Этот аргумент используется, когда параметр frequency_type имеет значение 32 (ежемесячно с относительной датой). frequency_relative_interval — это значение типа int, может иметь одно из указанных значений.Значение
Описание
1 (по умолчанию)
Первый
2
Второй
4
Третий
8
Четвертый
16
Последний
[ @frequency_recurrence_factor = ] frequency_recurrence_factor
Коэффициент повторения, используемый аргументом frequency_type. Аргумент frequency_recurrence_factor имеет тип int и значение по умолчанию 0.[ @frequency_subday = ] frequency_subday
Частота повторного планирования в течение определенного периода. frequency_subday — это значение типа int, может иметь одно из указанных значений.Значение
Описание
1
Однократно
2
Секунда
4 (по умолчанию)
Минута
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 и значение по умолчанию 0.[ @active_end_time_of_day = ] active_end_time_of_day
Время суток, на которое запланирован останов агента распространителя, в формате ЧЧММСС. active_end_time_of_dayимеет тип int и значение по умолчанию 235959, которое соответствует времени 23:59:59 в 24-часовом формате.[ @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_addsubscriber_schedule используется для репликации моментальных снимков, транзакций и репликации слиянием.
Разрешения
Только члены предопределенной роли сервера sysadmin могут выполнять процедуру sp_addsubscriber_schedule.