sp_changesubscriber (Transact-SQL)

Статья
12/22/2023

Применимо к:SQL Server Управляемый экземпляр SQL Azure

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

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

Синтаксис

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

Аргументы

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

[ @type = ] type Тип подписчика. Тип tinyint с значением NULL по умолчанию. 0 указывает подписчик Microsoft SQL Server. 1 указывает подписчик сервера источника данных ODBC, отличный от SQL Server или другого источника данных.

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

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

[ @commit_batch_size = ] commit_batch_size Поддерживается только для обратной совместимости.

[ @status_batch_size = ] status_batch_size Поддерживается только для обратной совместимости.

[ @flush_frequency = ] flush_frequency Поддерживается только для обратной совместимости.

[ @frequency_type = ] frequency_type Частота планирования задачи распространения. frequency_type является int и может быть одним из этих значений.

значение	Description
1	Один раз.
2	по запросу
4	Ежедневно
8	Неделя
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 и может быть одним из этих значений.

значение	Description
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 и может быть одним из этих значений.

значение	Description
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 = ] 'description' Является необязательным текстовым описанием. description — nvarchar (255) с значением NULL по умолчанию.

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

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

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

Примечание.

издатель не должен использоваться при изменении свойств статьи на издателе SQL Server.

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

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

Замечания

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

Разрешения

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

См. также

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