sp_changesubstatus (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.