sp_changesubstatus (Transact-SQL)
Изменяет параметры для подписчика. Обновляется любая задача распространения для подписчика для данного издателя. Эта хранимая процедура записывает в таблицу MSsubscriber_info в базе данных распространителя. Эта хранимая процедура выполняется в базе данных публикации на издателе.
Синтаксис
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'
Название подписчика, на котором изменяется параметр. Аргумент subscriber имеет тип sysname и не имеет значения по умолчанию.[ @type=] type
Тип подписчика. Аргумент type имеет тип tinyint и значение NULL по умолчанию. 0 означает подписчик Microsoft SQL Server. 1 указывает на подписчик, отличный от SQL Server или другой сервер источника данных ODBC.[ @login=] 'login'
Идентификатор входа проверки подлинности SQL Server. Аргумент login имеет тип sysname и значение NULL по умолчанию.[ @password=] '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
Еженедельно.
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
Первый.
2
Второй.
4
Третий.
8
Четвертый.
16
Последний.
[ @frequency_recurrence_factor=] frequency_recurrence_factor
Показывает, как часто задача распространения должна выполняться за время заданного frequency_type. Аргумент frequency_recurrence_factor имеет тип int и значение по умолчанию NULL.[ @frequency_subday=] frequency_subday
Частота повторного планирования во время заданного периода. Аргумент frequency_subday имеет тип int и может принимать одно из следующих значений.Значение
Описание
1
Однократно.
2
Секунда.
4
Минута.
8
Час.
[ @frequency_subday_interval=] frequency_subday_interval
Диапазон для frequence_subday. Аргумент frequency_subday_interval имеет тип int и значение по умолчанию NULL.[ @active_start_time_of_day=] active_start_time_of_day
Время, когда был первый раз запланирован запуск задачи распространения в формате ЧЧММСС. Аргумент active_start_time_of_day имеет тип int и значение по умолчанию NULL.[ @active_end_time_of_day=] active_end_time_of_day
Время, когда запуск задачи распространения был удален из расписания, в формате ЧЧММСС. Аргумент active_end_time_of_dayимеет тип int и значение по умолчанию NULL.[ @active_start_date=] active_start_date
Дата первого запуска задачи распространения в формате ГГГГММДД. Аргумент active_start_date имеет тип int и значение по умолчанию NULL.[ @active_end_date=] active_end_date
Дата, когда запуск задачи распространения был удален из расписания, в формате ГГГГММДД. Аргумент 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.Примечание Аргумент publisher не следует использовать при изменении свойств статьи в издателе SQL Server.
Значения кодов возврата
0 (успешное завершение) или 1 (неуспешное завершение)
Замечания
Процедура sp_changesubscriber используется во всех типах репликации.
Разрешения
Только члены предопределенной роли сервера sysadmin могут выполнять процедуру sp_changesubscriber.