sp_changesubscriber (Transact-SQL)

Изменяет параметры для подписчика. Обновляется любая задача распространения для подписчика для данного издателя. Эта хранимая процедура записывает в таблицу 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'
  Имя подписчика, на котором изменяется параметр. Аргумент 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.

См. также

Справочник

sp_addsubscriber (Transact-SQL)

sp_dropsubscriber (Transact-SQL)

sp_helpdistributiondb (Transact-SQL)

sp_helpserver (Transact-SQL)

sp_helpsubscriberinfo (Transact-SQL)

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