Поделиться через


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

    ms187968.note(ru-ru,SQL.90).gifПримечание.
    Аргумент publisher не должен указываться для издателя SQL Server.

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

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

Замечания

Процедура sp_addsubscriber_schedule используется для репликации моментальных снимков, транзакций и репликации слиянием.

Разрешения

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

См. также

Справочник

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

Справка и поддержка

Получение помощи по SQL Server 2005