Хранимая процедура 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.

См. также

Справочник

sp_changesubscriber_schedule (Transact-SQL)

Системные хранимые процедуры (Transact-SQL)