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


sp_addsubscriber (Transact-SQL)

Добавляет нового подписчика на издатель, разрешая ему получать публикации. Эта хранимая процедура выполняется в базе данных публикации на издателе для публикаций моментальных снимков и транзакций; а для публикаций слиянием с использованием удаленного распространителя эта хранимая процедура выполняется на распространителе.

ms188360.note(ru-ru,SQL.90).gifВажно!
Данная хранимая процедура является устаревшей. Явная регистрация подписчика на издателе больше не требуется.

Значок ссылки на разделСинтаксические обозначения в Transact-SQL

Синтаксис

sp_addsubscriber [ @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 ]
    [ , [ @encrypted_password = ] encrypted_password ]
    [ , [ @publisher = ] 'publisher' ]

Аргументы

  • [ @subscriber=] 'subscriber'
    Имя сервера, добавляемого в качестве допустимого подписчика на публикации этого сервера. Аргумент subscriber имеет тип sysname и не имеет значения по умолчанию.
  • [ @type=] type
    Тип подписчика. Аргумент type имеет тип tinyint и может принимать одно из следующих значений.

    Значение Описание

    0 (по умолчанию)

    Подписчик Microsoft SQL Server

    1

    Сервер источника данных ODBC

    2

    База данных Microsoft Jet

    3

    Поставщик OLE DB

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

    ms188360.note(ru-ru,SQL.90).gifПримечание.
    Данный аргумент является устаревшим и сохранен только для поддержки обратной совместимости. При выполнении процедуры sp_addsubscription значение свойства устанавливается в соответствии с подписками. Если значение указано, то оно используется в качестве значения по умолчанию при создании подписок на данном подписчике и при возвращении предупреждающего сообщения.
  • [ @password=] 'password'
    Пароль для проверки подлинности SQL Server. Аргумент password имеет тип nvarchar(524) и значение по умолчанию NULL.

    ms188360.security(ru-ru,SQL.90).gifПримечание безопасности.
    Не используйте пустой пароль. Пароль должен быть надежным.
    ms188360.note(ru-ru,SQL.90).gifПримечание.
    Данный аргумент является устаревшим и сохранен только для обратной совместимости сценариев. При выполнении процедуры sp_addsubscription значение свойства устанавливается в соответствии с подписками. Если значение указано, то оно используется в качестве значения по умолчанию при создании подписок на данном подписчике и при возвращении предупреждающего сообщения.
  • [ @commit_batch_size=] commit_batch_size
    Данный аргумент является устаревшим и сохранен только для обратной совместимости сценариев.

    ms188360.note(ru-ru,SQL.90).gifПримечание.
    Если значение указано, то оно используется в качестве значения по умолчанию при создании подписок на данном подписчике и при возвращении предупреждающего сообщения.
  • [ @status_batch_size=] status_batch_size
    Данный аргумент является устаревшим и сохранен только для обратной совместимости сценариев.

    ms188360.note(ru-ru,SQL.90).gifПримечание.
    Если значение указано, то оно используется в качестве значения по умолчанию при создании подписок на данном подписчике и при возвращении предупреждающего сообщения.
  • [ @flush_frequency=] flush_frequency
    Данный аргумент является устаревшим и сохранен только для обратной совместимости сценариев.

    ms188360.note(ru-ru,SQL.90).gifПримечание.
    Если значение указано, то оно используется в качестве значения по умолчанию при создании подписок на данном подписчике и при возвращении предупреждающего сообщения.
  • [ @frequency_type=] frequency_type
    Частота, с которой необходимо выполнять запланированные задания агента репликации. Аргумент frequency_type имеет тип int и может принимать одно из следующих значений.

    Значение Описание

    1

    Один раз

    2

    По требованию

    4

    Ежедневно

    8

    Еженедельно

    16

    Ежемесячно

    32

    По ежемесячному расписанию

    64 (по умолчанию)

    Автозапуск

    128

    Повторяющееся задание

    ms188360.note(ru-ru,SQL.90).gifПримечание.
    Данный аргумент является устаревшим и сохранен только для обратной совместимости сценариев. При выполнении процедуры sp_addsubscription значение свойства устанавливается в соответствии с подписками. Если значение указано, то оно используется в качестве значения по умолчанию при создании подписок на данном подписчике и при возвращении предупреждающего сообщения.
  • [@frequency_interval= ] frequency_interval
    Значение, применяемое к частоте, установленной аргументом frequency_type. Аргумент frequency_interval имеет тип int и значение по умолчанию 1.

    ms188360.note(ru-ru,SQL.90).gifПримечание.
    Данный аргумент является устаревшим и сохранен только для обратной совместимости сценариев. При выполнении процедуры sp_addsubscription значение свойства устанавливается в соответствии с подписками. Если значение указано, то оно используется в качестве значения по умолчанию при создании подписок на данном подписчике и при возвращении предупреждающего сообщения.
  • [ @frequency_relative_interval=] frequency_relative_interval
    Относительный интервал частоты. Этот параметр используется, если аргумент frequency_type имеет значение 32 (ежемесячное относительное расписание). Аргумент frequency_relative_interval имеет тип int и может принимать одно из следующих значений.

    Значение Описание

    1 (по умолчанию)

    Первый

    2

    Второй

    4

    Третий

    8

    Четвертый

    16

    Последний

    ms188360.note(ru-ru,SQL.90).gifПримечание.
    Данный аргумент является устаревшим и сохранен только для обратной совместимости сценариев. При выполнении процедуры sp_addsubscription значение свойства устанавливается в соответствии с подписками. Если значение указано, то оно используется в качестве значения по умолчанию при создании подписок на данном подписчике и при возвращении предупреждающего сообщения.
  • [ @frequency_recurrence_factor=] frequency_recurrence_factor
    Фактор периодичности, используемый аргументом frequency_type. Аргумент frequency_recurrence_factor имеет тип int и значение по умолчанию 0.

    ms188360.note(ru-ru,SQL.90).gifПримечание.
    Данный аргумент является устаревшим и сохранен только для обратной совместимости сценариев. При выполнении процедуры sp_addsubscription значение свойства устанавливается в соответствии с подписками. Если значение указано, то оно используется в качестве значения по умолчанию при создании подписок на данном подписчике и при возвращении предупреждающего сообщения.
  • [ @frequency_subday=] frequency_subday
    Частота повторного планирования во время заданного периода. Аргумент frequency_subday имеет тип int и может принимать одно из этих значений.

    Значение Описание

    1

    Однократно

    2

    Дважды

    4 (по умолчанию)

    Минута

    8

    Час

    ms188360.note(ru-ru,SQL.90).gifПримечание.
    Данный аргумент является устаревшим и сохранен только для обратной совместимости сценариев. При выполнении процедуры sp_addsubscription значение свойства устанавливается в соответствии с подписками. Если значение указано, то оно используется в качестве значения по умолчанию при создании подписок на данном подписчике и при возвращении предупреждающего сообщения.
  • [ @frequency_subday_interval=] frequency_subday_interval
    Интервал для аргумента frequency_subday. Аргумент frequency_subday_interval имеет тип int и значение по умолчанию 5.

    ms188360.note(ru-ru,SQL.90).gifПримечание.
    Данный аргумент является устаревшим и сохранен только для обратной совместимости сценариев. При выполнении процедуры sp_addsubscription значение свойства устанавливается в соответствии с подписками. Если значение указано, то оно используется в качестве значения по умолчанию при создании подписок на данном подписчике и при возвращении предупреждающего сообщения.
  • [ @active_start_time_of_day=] active_start_time_of_day
    Время суток, на которое запланирован первый запуск агента репликации, в формате ЧЧММСС. Аргумент active_start_time_of_day имеет тип int и значение по умолчанию 0.

    ms188360.note(ru-ru,SQL.90).gifПримечание.
    Данный аргумент является устаревшим и сохранен только для обратной совместимости сценариев. При выполнении процедуры sp_addsubscription значение свойства устанавливается в соответствии с подписками. Если значение указано, то оно используется в качестве значения по умолчанию при создании подписок на данном подписчике и при возвращении предупреждающего сообщения.
  • [ @active_end_time_of_day=] active_end_time_of_day
    Время суток, когда прекращаются запланированные задания агента репликации, в формате ЧЧММСС. Аргумент active_end_time_of_day имеет тип int и значение по умолчанию 235959, означающее 23:59:59.

    ms188360.note(ru-ru,SQL.90).gifПримечание.
    Данный аргумент является устаревшим и сохранен только для обратной совместимости сценариев. При выполнении процедуры sp_addsubscription значение свойства устанавливается в соответствии с подписками. Если значение указано, то оно используется в качестве значения по умолчанию при создании подписок на данном подписчике и при возвращении предупреждающего сообщения.
  • [ @active_start_date=] active_start_date
    Дата первого запланированного запуска агента репликации в формате ГГГГММДД. Аргумент active_start_date имеет тип int и значение по умолчанию 0.

    ms188360.note(ru-ru,SQL.90).gifПримечание.
    Данный аргумент является устаревшим и сохранен только для обратной совместимости сценариев. При выполнении процедуры sp_addsubscription значение свойства устанавливается в соответствии с подписками. Если значение указано, то оно используется в качестве значения по умолчанию при создании подписок на данном подписчике и при возвращении предупреждающего сообщения.
  • [ @active_end_date=] active_end_date
    Дата первого запланированного останова агента репликации в формате ГГГГММДД. Аргумент active_end_date имеет тип int и значение по умолчанию 99991231, что соответствует 31 декабря 9999 года.

    ms188360.note(ru-ru,SQL.90).gifПримечание.
    Данный аргумент является устаревшим и сохранен только для обратной совместимости сценариев. При выполнении процедуры sp_addsubscription значение свойства устанавливается в соответствии с подписками. Если значение указано, то оно используется в качестве значения по умолчанию при создании подписок на данном подписчике и при возвращении предупреждающего сообщения.
  • [ @description=] 'description'
    Тестовое описание подписчика. Аргумент description имеет тип nvarchar(255) и значение по умолчанию NULL.
  • [ @security_mode=] security_mode
    Реализованный режим безопасности. Аргумент security_mode имеет тип int и значение по умолчанию 1. Значение 0 указывает проверку подлинности SQL Server. Значение 1 указывает проверку подлинности Windows.

    ms188360.note(ru-ru,SQL.90).gifПримечание.
    Данный аргумент является устаревшим и сохранен только для обратной совместимости сценариев. При выполнении процедуры sp_addsubscription значение свойства устанавливается в соответствии с подписками. Если значение указано, то оно используется в качестве значения по умолчанию при создании подписок на данном подписчике и при возвращении предупреждающего сообщения.
  • [ @encrypted_password=] encrypted_password
    Этот аргумент является устаревшим и сохранен только для обратной совместимости. Установка аргумента encrypted_password в любое значение, отличное от 0, приведет к ошибке.
  • [ @publisher= ] 'publisher'
    Задает издатель, отличный от SQL Server. Аргумент publisher имеет тип sysname и значение по умолчанию NULL.

    ms188360.note(ru-ru,SQL.90).gifПримечание.
    Аргумент publisher не должен использоваться при публикации данных с издателя SQL Server.

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

0 (успешное завершение) или 1 (неуспешное завершение)

Замечания

Процедура sp_addsubscriber используется в репликации моментальных снимков, репликации транзакций и репликации слиянием.

Процедура sp_addsubscriber не требуется, если подписчик будет иметь только анонимные подписки на публикации слиянием.

Процедура sp_addsubscriber осуществляет запись в таблицу MSsubscriber_info базы данных distribution.

Разрешения

Процедуру sp_addsubscriber могут выполнять только члены фиксированной серверной роли sysadmin.

См. также

Справочник

sp_changesubstatus (Transact-SQL)
sp_dropsubscriber (Transact-SQL)
sp_helpsubscriberinfo (Transact-SQL)

Другие ресурсы

Как создавать принудительные подписки (программирование репликации на языке Transact-SQL)
Как создавать подписки по запросу (программирование репликации на языке Transact-SQL)

Справка и поддержка

Получение помощи по SQL Server 2005