sp_addsubscriber (Transact-SQL)sp_addsubscriber (Transact-SQL)

Применимо к:Applies to: даSQL ServerSQL Server (все поддерживаемые версии) yesSQL ServerSQL Server (all supported versions) ДаБаза данных SQL AzureAzure SQL DatabaseYesБаза данных SQL AzureAzure SQL DatabaseПрименимо к:Applies to: даSQL ServerSQL Server (все поддерживаемые версии) yesSQL ServerSQL Server (all supported versions) ДаБаза данных SQL AzureAzure SQL DatabaseYesБаза данных SQL AzureAzure SQL Database

Добавляет нового подписчика на издатель, разрешая ему получать публикации.Adds a new Subscriber to a Publisher, enabling it to receive publications. Эта хранимая процедура выполняется в базе данных публикации на издателе для публикаций моментальных снимков и транзакций; а для публикаций слиянием с использованием удаленного распространителя эта хранимая процедура выполняется на распространителе.This stored procedure is executed at the Publisher on the publication database for snapshot and transactional publications; and for merge publications using a remote Distributor, this stored procedure is executed at the Distributor.

Важно!

Данная хранимая процедура является устаревшей.This stored procedure has been deprecated. Явная регистрация подписчика на издателе больше не требуется.You are no longer required to explicitly register a Subscriber at the Publisher.

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

СинтаксисSyntax

  
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' ]  

АргументыArguments

[ @subscriber = ] 'subscriber' Имя сервера, добавляемого в качестве допустимого подписчика на публикации на этом сервере.[ @subscriber = ] 'subscriber' Is the name of the server to be added as a valid Subscriber to the publications on this server. Аргумент Subscriber имеет тип sysnameи не имеет значения по умолчанию.subscriber is sysname, with no default.

[ @type = ] type Тип подписчика.[ @type = ] type Is the type of Subscriber. Type имеет тип tinyintи может принимать одно из следующих значений.type is tinyint, and can be one of these values.

ЗначениеValue ОписаниеDescription
0 (по умолчанию)0 (default) MicrosoftMicrosoftSQL ServerSQL ServerПодписчикSQL ServerSQL Server Subscriber
11 Сервер источника данных ODBCODBC data source server
22 База данных MicrosoftMicrosoft JetMicrosoftMicrosoft Jet database
33 Поставщик OLE DBOLE DB provider

[ @login = ] 'login' Идентификатор входа для SQL ServerSQL Server проверки подлинности.[ @login = ] 'login' Is the login ID for SQL ServerSQL Server Authentication. Аргумент login имеет тип sysname и значение по умолчанию NULL.login is sysname, with a default of NULL.

Примечание

Данный аргумент является устаревшим и сохранен только для поддержки обратной совместимости скриптов.This parameter has been deprecated and is maintained for backward compatibility of scripts. Свойство теперь указывается для каждой подписки при выполнении sp_addsubscription.The property is now specified on a per-subscription basis when executing sp_addsubscription. Если значение указано, то оно используется в качестве значения по умолчанию при создании подписок на данном подписчике и при возвращении предупреждающего сообщения.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @password = ] 'password' Пароль для SQL ServerSQL Server проверки подлинности.[ @password = ] 'password' Is the password for SQL ServerSQL Server Authentication. Password имеет тип nvarchar (524) и значение по умолчанию NULL.password is nvarchar(524), with a default of NULL.

Важно!

Не используйте пустые пароли.Do not use a blank password. Выбирайте надежные пароли.Use a strong password.

Примечание

Данный аргумент является устаревшим и сохранен только для поддержки обратной совместимости скриптов.This parameter has been deprecated and is maintained for backward compatibility of scripts. Свойство теперь указывается для каждой подписки при выполнении sp_addsubscription.The property is now specified on a per-subscription basis when executing sp_addsubscription. Если значение указано, то оно используется в качестве значения по умолчанию при создании подписок на данном подписчике и при возвращении предупреждающего сообщения.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @commit_batch_size = ] commit_batch_size Этот параметр является устаревшим и поддерживается для обратной совместимости скриптов.[ @commit_batch_size = ] commit_batch_size This parameter has been deprecated and is maintained for backward compatibility of scripts.

Примечание

Если значение указано, то оно используется в качестве значения по умолчанию при создании подписок на данном подписчике и при возвращении предупреждающего сообщения.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @status_batch_size = ] status_batch_size Этот параметр является устаревшим и поддерживается для обратной совместимости скриптов.[ @status_batch_size = ] status_batch_size This parameter has been deprecated and is maintained for backward compatibility of scripts.

Примечание

Если значение указано, то оно используется в качестве значения по умолчанию при создании подписок на данном подписчике и при возвращении предупреждающего сообщения.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @flush_frequency = ] flush_frequency Этот параметр является устаревшим и поддерживается для обратной совместимости скриптов.[ @flush_frequency = ] flush_frequency This parameter has been deprecated and is maintained for backward compatibility of scripts.

Примечание

Если значение указано, то оно используется в качестве значения по умолчанию при создании подписок на данном подписчике и при возвращении предупреждающего сообщения.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @frequency_type = ] frequency_type Частота, с которой необходимо запланировать агент репликации.[ @frequency_type = ] frequency_type Is the frequency with which to schedule the replication agent. frequency_type имеет тип intи может принимать одно из следующих значений.frequency_type is int, and can be one of these values.

ЗначениеValue ОписаниеDescription
11 Один раз.One time
22 По запросуOn demand
44 ЕжедневноDaily
88 ЕженедельноWeekly
1616 ЕжемесячноMonthly
3232 Ежемесячно с относительной датойMonthly relative
64 (по умолчанию)64 (default) АвтозапускAutostart
128128 Повторяющееся заданиеRecurring

Примечание

Данный аргумент является устаревшим и сохранен только для поддержки обратной совместимости скриптов.This parameter has been deprecated and is maintained for backward compatibility of scripts. Свойство теперь указывается для каждой подписки при выполнении sp_addsubscription.The property is now specified on a per-subscription basis when executing sp_addsubscription. Если значение указано, то оно используется в качестве значения по умолчанию при создании подписок на данном подписчике и при возвращении предупреждающего сообщения.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @frequency_interval = ] frequency_interval Значение, применяемое к частоте, установленной frequency_type.[ @frequency_interval = ] frequency_interval Is the value applied to the frequency set by frequency_type. frequency_interval имеет тип intи значение по умолчанию 1.frequency_interval is int, with a default of 1.

Примечание

Данный аргумент является устаревшим и сохранен только для поддержки обратной совместимости скриптов.This parameter has been deprecated and is maintained for backward compatibility of scripts. Свойство теперь указывается для каждой подписки при выполнении sp_addsubscription.The property is now specified on a per-subscription basis when executing sp_addsubscription. Если значение указано, то оно используется в качестве значения по умолчанию при создании подписок на данном подписчике и при возвращении предупреждающего сообщения.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @frequency_relative_interval = ] frequency_relative_interval Дата агента репликации.[ @frequency_relative_interval = ] frequency_relative_interval Is the date of the replication agent. Этот параметр используется, если frequency_type установлен в значение 32 (ежемесячное относительное расписание).This parameter is used when frequency_type is set to 32 (monthly relative). frequency_relative_interval имеет тип intи может принимать одно из следующих значений.frequency_relative_interval is int, and can be one of these values.

ЗначениеValue ОписаниеDescription
1 (по умолчанию)1 (default) FirstFirst
22 SecondSecond
44 ТретьеThird
88 ЧетвертаяFourth
1616 ПоследнийLast

Примечание

Данный аргумент является устаревшим и сохранен только для поддержки обратной совместимости скриптов.This parameter has been deprecated and is maintained for backward compatibility of scripts. Свойство теперь указывается для каждой подписки при выполнении sp_addsubscription.The property is now specified on a per-subscription basis when executing sp_addsubscription. Если значение указано, то оно используется в качестве значения по умолчанию при создании подписок на данном подписчике и при возвращении предупреждающего сообщения.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @frequency_recurrence_factor = ] frequency_recurrence_factor Коэффициент повторения, используемый frequency_type.[ @frequency_recurrence_factor = ] frequency_recurrence_factor Is the recurrence factor used by frequency_type. frequency_recurrence_factor имеет тип intи значение по умолчанию 0.frequency_recurrence_factor is int, with a default of 0.

Примечание

Данный аргумент является устаревшим и сохранен только для поддержки обратной совместимости скриптов.This parameter has been deprecated and is maintained for backward compatibility of scripts. Свойство теперь указывается для каждой подписки при выполнении sp_addsubscription.The property is now specified on a per-subscription basis when executing sp_addsubscription. Если значение указано, то оно используется в качестве значения по умолчанию при создании подписок на данном подписчике и при возвращении предупреждающего сообщения.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @frequency_subday = ] frequency_subday Частота повторного планирования в течение заданного периода.[ @frequency_subday = ] frequency_subday Is how often to reschedule during the defined period. frequency_subday имеет тип intи может принимать одно из следующих значений.frequency_subday is int, and can be one of these values.

ЗначениеValue ОписаниеDescription
11 ОднократноOnce
22 SecondSecond
4 (по умолчанию)4 (default) МинутаMinute
88 ЧасHour

Примечание

Данный аргумент является устаревшим и сохранен только для поддержки обратной совместимости скриптов.This parameter has been deprecated and is maintained for backward compatibility of scripts. Свойство теперь указывается для каждой подписки при выполнении sp_addsubscription.The property is now specified on a per-subscription basis when executing sp_addsubscription. Если значение указано, то оно используется в качестве значения по умолчанию при создании подписок на данном подписчике и при возвращении предупреждающего сообщения.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @frequency_subday_interval = ] frequency_subday_interval Интервал для frequency_subday.[ @frequency_subday_interval = ] frequency_subday_interval Is the interval for frequency_subday. frequency_subday_interval имеет тип intи значение по умолчанию 5.frequency_subday_interval is int, with a default of 5.

Примечание

Данный аргумент является устаревшим и сохранен только для поддержки обратной совместимости скриптов.This parameter has been deprecated and is maintained for backward compatibility of scripts. Свойство теперь указывается для каждой подписки при выполнении sp_addsubscription.The property is now specified on a per-subscription basis when executing sp_addsubscription. Если значение указано, то оно используется в качестве значения по умолчанию при создании подписок на данном подписчике и при возвращении предупреждающего сообщения.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @active_start_time_of_day = ] active_start_time_of_day Время суток, когда запланирован первый запуск агента репликации, в формате ЧЧММСС.[ @active_start_time_of_day = ] active_start_time_of_day Is the time of day when the replication agent is first scheduled, formatted as HHMMSS. active_start_time_of_day имеет тип intи значение по умолчанию 0.active_start_time_of_day is int, with a default of 0.

Примечание

Данный аргумент является устаревшим и сохранен только для поддержки обратной совместимости скриптов.This parameter has been deprecated and is maintained for backward compatibility of scripts. Свойство теперь указывается для каждой подписки при выполнении sp_addsubscription.The property is now specified on a per-subscription basis when executing sp_addsubscription. Если значение указано, то оно используется в качестве значения по умолчанию при создании подписок на данном подписчике и при возвращении предупреждающего сообщения.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @active_end_time_of_day = ] active_end_time_of_day Время суток, когда запланирована остановка агента репликации, в формате ЧЧММСС.[ @active_end_time_of_day = ] active_end_time_of_day Is the time of day when the replication agent stops being scheduled, formatted as HHMMSS. active_end_time_of_dayимеет тип intи значение по умолчанию 235959, то есть 11:59:59 P.M.active_end_time_of_dayis int, with a default of 235959, which means 11:59:59 P.M. в 24-часовом формате.as measured on a 24-hour clock.

Примечание

Данный аргумент является устаревшим и сохранен только для поддержки обратной совместимости скриптов.This parameter has been deprecated and is maintained for backward compatibility of scripts. Свойство теперь указывается для каждой подписки при выполнении sp_addsubscription.The property is now specified on a per-subscription basis when executing sp_addsubscription. Если значение указано, то оно используется в качестве значения по умолчанию при создании подписок на данном подписчике и при возвращении предупреждающего сообщения.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @active_start_date = ] active_start_date Дата первого запланированного запуска агента репликации в формате ГГГГММДД.[ @active_start_date = ] active_start_date Is the date when the replication agent is first scheduled, formatted as YYYYMMDD. active_start_date имеет тип intи значение по умолчанию 0.active_start_date is int, with a default of 0.

Примечание

Данный аргумент является устаревшим и сохранен только для поддержки обратной совместимости скриптов.This parameter has been deprecated and is maintained for backward compatibility of scripts. Свойство теперь указывается для каждой подписки при выполнении sp_addsubscription.The property is now specified on a per-subscription basis when executing sp_addsubscription. Если значение указано, то оно используется в качестве значения по умолчанию при создании подписок на данном подписчике и при возвращении предупреждающего сообщения.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @active_end_date = ] active_end_date Дата запланированной остановки агента репликации в формате ГГГГММДД.[ @active_end_date = ] active_end_date Is the date when the replication agent stops being scheduled, formatted as YYYYMMDD. active_end_date имеет тип intи значение по умолчанию 99991231, что означает 31 декабря 9999.active_end_date is int, with a default of 99991231, which means December 31, 9999.

Примечание

Данный аргумент является устаревшим и сохранен только для поддержки обратной совместимости скриптов.This parameter has been deprecated and is maintained for backward compatibility of scripts. Свойство теперь указывается для каждой подписки при выполнении sp_addsubscription.The property is now specified on a per-subscription basis when executing sp_addsubscription. Если значение указано, то оно используется в качестве значения по умолчанию при создании подписок на данном подписчике и при возвращении предупреждающего сообщения.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @description = ] 'description' Текстовое описание подписчика.[ @description = ] 'description' Is a text description of the Subscriber. Description имеет тип nvarchar (255) и значение по умолчанию NULL.description is nvarchar(255), with a default of NULL.

[ @security_mode = ] security_mode Реализованный режим безопасности.[ @security_mode = ] security_mode Is the implemented security mode. security_mode имеет тип intи значение по умолчанию 1.security_mode is int, with a default of 1. 0SQL ServerSQL Server Проверка подлинности.0 specifies SQL ServerSQL Server Authentication. 1 указывает проверку подлинности Windows.1 specifies Windows Authentication.

Примечание

Данный аргумент является устаревшим и сохранен только для поддержки обратной совместимости скриптов.This parameter has been deprecated and is maintained for backward compatibility of scripts. Свойство теперь указывается для каждой подписки при выполнении sp_addsubscription.The property is now specified on a per-subscription basis when executing sp_addsubscription. Если значение указано, то оно используется в качестве значения по умолчанию при создании подписок на данном подписчике и при возвращении предупреждающего сообщения.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @encrypted_password = ] encrypted_password Этот параметр является устаревшим и предоставляется для обеспечения обратной совместимости, если параметру encrypted_password любое значение, но 0 приведет к ошибке.[ @encrypted_password = ] encrypted_password This parameter has been deprecated and is provided for backward-compatibility only Setting encrypted_password to any value but 0 will result in an error.

[ @publisher = ] 'publisher' Указывает издателя, отличного от SQL ServerSQL Server .[ @publisher = ] 'publisher' Specifies a non- SQL ServerSQL Server Publisher. Аргумент Publisher имеет тип sysnameи значение по умолчанию NULL.publisher is sysname, with a default of NULL.

Примечание

При публикации с издателя не следует использовать Издатель SQL ServerSQL Server .publisher should not be used when publishing from a SQL ServerSQL Server Publisher.

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

0 (успешное завершение) или 1 (сбой)0 (success) or 1 (failure)

ПримечанияRemarks

sp_addsubscriber используется в репликации моментальных снимков, репликации транзакций и репликации слиянием.sp_addsubscriber is used in snapshot replication, transactional replication, and merge replication.

sp_addsubscriber не требуется, если подписчик будет иметь только анонимные подписки на публикации слиянием.sp_addsubscriber is not required when the Subscriber will only have anonymous subscriptions to merge publications.

sp_addsubscriber запись в таблицу MSsubscriber_info в базе данных распространителя .sp_addsubscriber writes to the MSsubscriber_info table in the distribution database.

РазрешенияPermissions

Только члены предопределенной роли сервера sysadmin могут выполнять sp_addsubscriber.Only members of the sysadmin fixed server role can execute sp_addsubscriber.

См. такжеSee Also

Create a Push Subscription Create a Push Subscription
Create a Pull Subscription Create a Pull Subscription
sp_changesubscriber (Transact-SQL) sp_changesubscriber (Transact-SQL)
sp_dropsubscriber (Transact-SQL) sp_dropsubscriber (Transact-SQL)
sp_helpsubscriberinfo (Transact-SQL)sp_helpsubscriberinfo (Transact-SQL)