sp_addsubscriber (Transact-SQL)

Применимо к:SQL Server База данных SQL Azure

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

Важно!

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

Соглашения о синтаксисе Transact-SQL

Синтаксис

sp_addsubscriber
    [ @subscriber = ] N'subscriber'
    [ , [ @type = ] type ]
    [ , [ @login = ] N'login' ]
    [ , [ @password = ] N'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 = ] N'description' ]
    [ , [ @security_mode = ] security_mode ]
    [ , [ @encrypted_password = ] encrypted_password ]
    [ , [ @publisher = ] N'publisher' ]
[ ; ]

Аргументы

[ @subscriber = ] N'подписчик'

Имя сервера, добавляемого в качестве допустимого подписчика, к публикациям на этом сервере. @subscriber — sysname без значения по умолчанию.

[ @type = ] тип

Тип подписчика. @type крошечный и может быть одним из этих значений.

значение	Описание
0 (по умолчанию)	Подписчик SQL Server
1	Сервер источника данных ODBC
2	База данных Microsoft Jet
3	Поставщик OLE DB

[ @login = ] N'login'

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

Примечание.

Этот параметр устарел и поддерживается для обратной совместимости скриптов. Теперь свойство указывается на основе каждой подписки при выполнении sp_addsubscription. Если указано значение, оно используется в качестве значения по умолчанию при создании подписок на этом подписчике и возвращается предупреждение.

[ @password = ] N'password'

Пароль для проверки подлинности SQL Server. @password — nvarchar(524) с значением по умолчаниюNULL.

Не используйте пустой пароль. Выбирайте надежные пароли.

Примечание.

Этот параметр устарел и поддерживается для обратной совместимости скриптов. Теперь свойство указывается на основе каждой подписки при выполнении sp_addsubscription. Если указано значение, оно используется в качестве значения по умолчанию при создании подписок на этом подписчике и возвращается предупреждение.

[ @commit_batch_size = ] commit_batch_size

Этот параметр устарел и поддерживается для обратной совместимости скриптов.

Если указано значение, оно используется в качестве значения по умолчанию при создании подписок на этом подписчике и возвращается предупреждение.

[ @status_batch_size = ] status_batch_size

Этот параметр устарел и поддерживается для обратной совместимости скриптов.

Если указано значение, оно используется в качестве значения по умолчанию при создании подписок на этом подписчике и возвращается предупреждение.

[ @flush_frequency = ] flush_frequency

Этот параметр устарел и поддерживается для обратной совместимости скриптов.

Если указано значение, оно используется в качестве значения по умолчанию при создании подписок на этом подписчике и возвращается предупреждение.

[ @frequency_type = ] frequency_type

Указывает частоту планирования агента реплика tion. @frequency_type является int и может быть одним из этих значений.

значение	Описание
1	Один раз.
2	по запросу
4	Ежедневно
8	Weekly (Еженедельно);
16	Ежемесячная
32	Ежемесячно с относительной датой
64 (по умолчанию)	Автозапуск
128	Повторяющееся задание

Примечание.

Этот параметр устарел и поддерживается для обратной совместимости скриптов. Теперь свойство указывается на основе каждой подписки при выполнении sp_addsubscription. Если указано значение, оно используется в качестве значения по умолчанию при создании подписок на этом подписчике и возвращается предупреждение.

[ @frequency_interval = ] frequency_interval

Значение, применяемое к частоте, заданной @frequency_type. @frequency_interval имеет значение int с значением по умолчанию1.

Примечание.

Этот параметр устарел и поддерживается для обратной совместимости скриптов. Теперь свойство указывается на основе каждой подписки при выполнении sp_addsubscription. Если указано значение, оно используется в качестве значения по умолчанию при создании подписок на этом подписчике и возвращается предупреждение.

[ @frequency_relative_interval = ] frequency_relative_interval

Дата агента реплика tion. Этот параметр используется, если @frequency_type задано 32 значение (ежемесячное относительное). @frequency_relative_interval является int и может быть одним из этих значений.

значение	Описание
1 (по умолчанию)	First
2	Second
4	Третья
8	Четвертая
16	Last

Примечание.

Этот параметр устарел и поддерживается для обратной совместимости скриптов. Теперь свойство указывается на основе каждой подписки при выполнении sp_addsubscription. Если указано значение, оно используется в качестве значения по умолчанию при создании подписок на этом подписчике и возвращается предупреждение.

[ @frequency_recurrence_factor = ] frequency_recurrence_factor

Коэффициент повторения, используемый @frequency_type. @frequency_recurrence_factor имеет значение int с значением по умолчанию0.

Примечание.

Этот параметр устарел и поддерживается для обратной совместимости скриптов. Теперь свойство указывается на основе каждой подписки при выполнении sp_addsubscription. Если указано значение, оно используется в качестве значения по умолчанию при создании подписок на этом подписчике и возвращается предупреждение.

[ @frequency_subday = ] frequency_subday

Как часто следует перепланировать расписание в течение определенного периода. @frequency_subday является int и может быть одним из этих значений.

значение	Описание
1	Однократно
2	Second
4 (по умолчанию)	Minute
8	Часы

Примечание.

Этот параметр устарел и поддерживается для обратной совместимости скриптов. Теперь свойство указывается на основе каждой подписки при выполнении sp_addsubscription. Если указано значение, оно используется в качестве значения по умолчанию при создании подписок на этом подписчике и возвращается предупреждение.

[ @frequency_subday_interval = ] frequency_subday_interval

Интервал для frequency_subday. @frequency_subday_interval имеет значение int с значением по умолчанию5.

Примечание.

Этот параметр устарел и поддерживается для обратной совместимости скриптов. Теперь свойство указывается на основе каждой подписки при выполнении sp_addsubscription. Если указано значение, оно используется в качестве значения по умолчанию при создании подписок на этом подписчике и возвращается предупреждение.

[ @active_start_time_of_day = ] active_start_time_of_day

Время дня, когда агент реплика tion сначала запланирован, отформатирован как HHmmss. @active_start_time_of_day имеет значение int с значением по умолчанию0.

Примечание.

Этот параметр устарел и поддерживается для обратной совместимости скриптов. Теперь свойство указывается на основе каждой подписки при выполнении sp_addsubscription. Если указано значение, оно используется в качестве значения по умолчанию при создании подписок на этом подписчике и возвращается предупреждение.

[ @active_end_time_of_day = ] active_end_time_of_day

Время дня, когда агент реплика tion перестает планироваться, отформатирован как HHmmss. @active_end_time_of_day является int, с по умолчанию235959, что означает 11:59:59 вечера, как измеряется на 24-часовых часах.

Примечание.

Этот параметр устарел и поддерживается для обратной совместимости скриптов. Теперь свойство указывается на основе каждой подписки при выполнении sp_addsubscription. Если указано значение, оно используется в качестве значения по умолчанию при создании подписок на этом подписчике и возвращается предупреждение.

[ @active_start_date = ] active_start_date

Дата, когда агент реплика tion сначала запланирован, отформатирован как yyyyMMdd. @active_start_date имеет значение int с значением по умолчанию0.

Примечание.

Этот параметр устарел и поддерживается для обратной совместимости скриптов. Теперь свойство указывается на основе каждой подписки при выполнении sp_addsubscription. Если указано значение, оно используется в качестве значения по умолчанию при создании подписок на этом подписчике и возвращается предупреждение.

[ @active_end_date = ] active_end_date

Дата, когда агент реплика tion перестает быть запланирован, отформатирован как yyyyMMdd. @active_end_date является int, с значением по умолчанию99991231, что означает 31 декабря 9999 года.

Примечание.

Этот параметр устарел и поддерживается для обратной совместимости скриптов. Теперь свойство указывается на основе каждой подписки при выполнении sp_addsubscription. Если указано значение, оно используется в качестве значения по умолчанию при создании подписок на этом подписчике и возвращается предупреждение.

[ @description = ] N'description'

Текстовое описание подписчика. @description имеет значение nvarchar(255) с значением по умолчаниюNULL.

[ @security_mode = ] security_mode

Реализованный режим безопасности. @security_mode имеет значение int с значением по умолчанию1.

• 0 указывает проверку подлинности SQL Server.
• 1указывает проверка подлинности Windows.

Примечание.

Этот параметр устарел и поддерживается для обратной совместимости скриптов. Теперь свойство указывается на основе каждой подписки при выполнении sp_addsubscription. Если указано значение, оно используется в качестве значения по умолчанию при создании подписок на этом подписчике и возвращается предупреждение.

[ @encrypted_password = ] encrypted_password

Этот параметр не рекомендуется использовать и предоставляется только для обратной совместимости. Установка @encrypted_password для любого значения, но 0 приводит к ошибке.

[ @publisher = ] N'publisher'

Указывает издатель, отличный от SQL Server. @publisher — sysname с значением по умолчаниюNULL.

@publisher не следует использовать при публикации с издателя SQL Server.

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

0 (успешно) или 1 (сбой).

Замечания

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

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

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

Разрешения

Могут выполняться sp_addsubscriberтолько члены предопределенных ролей сервера sysadmin.

Связанный контент

• Создание принудительной подписки
• Create a Pull Subscription
• sp_changesubscriber (Transact-SQL)
• sp_dropsubscriber (Transact-SQL)
• sp_helpsubscriberinfo (Transact-SQL)