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


sp_changesubscriber (Transact-SQL)

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

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

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

Синтаксис

sp_changesubscriber
    [ @subscriber = ] N'subscriber'
    [ , [ @type = ] type ]
    [ , [ @login = ] N'login' ]
    [ , [ @password = ] N'password' ]
    [ , [ @commit_batch_size = ] commit_batch_size ]
    [ , [ @status_batch_size = ] status_batch_size ]
    [ , [ @flush_frequency = ] flush_frequency ]
    [ , [ @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 ]
    [ , [ @description = ] N'description' ]
    [ , [ @security_mode = ] security_mode ]
    [ , [ @publisher = ] N'publisher' ]
[ ; ]

Аргументы

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

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

[ @type = ] тип

Тип подписчика. @type имеет крошечный размер с значением по умолчаниюNULL.

  • 0 указывает подписчик SQL Server.
  • 1 указывает подписчик сервера источника данных ODBC, отличный от SQL Server или другой.

[ @login = ] N'login'

Идентификатор входа проверки подлинности SQL Server. @login имеет имя sysname с значением по умолчаниюNULL.

[ @password = ] N'password'

Пароль проверки подлинности SQL Server. @password имеет имя sysname с значением по умолчанию%, указывающее, что нет изменений в свойстве пароля.

[ @commit_batch_size = ] commit_batch_size

Этот параметр устарел и поддерживается для обратной совместимости скриптов.

[ @status_batch_size = ] status_batch_size

Этот параметр устарел и поддерживается для обратной совместимости скриптов.

[ @flush_frequency = ] flush_frequency

Этот параметр устарел и поддерживается для обратной совместимости скриптов.

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

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

[ @frequency_subday = ] frequency_subday

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

значение Описание
1 Однократно
2 Second
4 Minute
8 Часы

[ @frequency_subday_interval = ] frequency_subday_interval

Интервал для @frequence_subday. @frequency_subday_interval имеет значение int с значением по умолчаниюNULL.

[ @active_start_time_of_day = ] active_start_time_of_day

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

[ @active_end_time_of_day = ] active_end_time_of_day

Время дня, когда задача распространения перестает планироваться, отформатирована как HHmmss. @active_end_time_of_day имеет значение int с значением по умолчаниюNULL.

[ @active_start_date = ] active_start_date

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

[ @active_end_date = ] active_end_date

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

[ @description = ] N'description'

Необязательное текстовое описание. @description имеет значение nvarchar(255) с значением по умолчаниюNULL.

[ @security_mode = ] security_mode

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

значение Описание
0 Проверка подлинности SQL Server
1 Проверка подлинности Windows

[ @publisher = ] N'publisher'

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

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

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

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

Замечания

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

Разрешения

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