Хранимая процедура sp_addsubscriber_schedule (Transact-SQL)
Область применения: SQL Server Управляемый экземпляр SQL Azure
Добавляет расписание агента распространителя и агента слияния. Эта хранимая процедура выполняется на подписчике в любой базе данных.
Соглашения о синтаксисе Transact-SQL
Синтаксис
sp_addsubscriber_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 без значения по умолчанию. @subscriber должен быть уникальным в базе данных, не должен существовать и не может бытьNULL
.
[ @agent_type = ] agent_type
Тип агента. @agent_type имеет небольшой размер и может быть одним из этих значений.
значение | Описание |
---|---|
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 с значением по умолчанию1
.
[ @frequency_relative_interval = ] frequency_relative_interval
Дата агент распространения. Этот параметр используется, если для frequency_type задано значение 32
(ежемесячное относительное). @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
Время дня, когда агент распространения сначала запланировано, отформатировано как HHmmss
. @active_start_time_of_day имеет значение int с значением по умолчанию0
.
[ @active_end_time_of_day = ] active_end_time_of_day
Время дня, когда агент распространения перестает планироваться, форматируется как HHmmss
. @active_end_time_of_day является int, с по умолчанию235959
, что означает 11:59:59 вечера, как измеряется на 24-часовых часах.
[ @active_start_date = ] active_start_date
Дата, когда агент распространения впервые запланирована, отформатирована как yyyyMMdd
. @active_start_date имеет значение int с значением по умолчанию0
.
[ @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_addsubscriber_schedule
используется в репликации моментальных снимков, репликации транзакций и репликации слиянием.
Разрешения
Могут выполняться sp_addsubscriber_schedule
только члены предопределенных ролей сервера sysadmin.