sp_addpullsubscription (Transact-SQL)

Область применения: SQL Server Управляемый экземпляр SQL Azure

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

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

Синтаксис

sp_addpullsubscription
    [ @publisher = ] N'publisher'
    [ , [ @publisher_db = ] N'publisher_db' ]
    , [ @publication = ] N'publication'
    [ , [ @independent_agent = ] N'independent_agent' ]
    [ , [ @subscription_type = ] N'subscription_type' ]
    [ , [ @description = ] N'description' ]
    [ , [ @update_mode = ] N'update_mode' ]
    [ , [ @immediate_sync = ] immediate_sync ]
[ ; ]

Аргументы

[ @publisher = ] N'publisher'

Имя издателя. @publisher — sysname без значения по умолчанию.

[ @publisher_db = ] N'publisher_db'

Имя базы данных издателя. @publisher_db имеет имя sysname с значением по умолчаниюNULL. @publisher_db игнорируется издателями Oracle.

[ @publication = ] N'publication'

Имя публикации. @publication — sysname без значения по умолчанию.

[ @independent_agent = ] N'independent_agent'

Указывает, есть ли автономный агент распространения для этой публикации. @independent_agent — nvarchar(5) с значением по умолчаниюtrue.

• Если trueдля этой публикации существует автономный агент распространения.
• Если falseдля каждой пары баз данных издателя или подписчика существует одна агент распространения.

@independent_agent является свойством публикации и должно иметь то же значение, что и издатель.

[ @subscription_type = ] N'subscription_type'

Тип подписки. @subscription_type — nvarchar(9) с значением по умолчаниюanonymous. Необходимо указать значение pull для @subscription_type, если вы не хотите создать подписку без регистрации подписки на издателе. В этом случае необходимо указать значение anonymous. Это необходимо для случаев, в которых невозможно установить подключение SQL Server к издателю во время настройки подписки.

[ @description = ] N'description'

Описание публикации. @description — nvarchar(100) с значением по умолчаниюNULL.

[ @update_mode = ] N'update_mode'

Тип обновления. @update_mode — nvarchar(30) и может быть одним из следующих значений.

[ @immediate_sync = ] immediate_sync

Указывает, создаются ли файлы синхронизации или создаются повторно при каждом запуске агент моментальных снимков. @immediate_sync бит, по умолчанию 1и должен иметь то же значение, что и @immediate_sync в sp_addpublication. @immediate_sync является свойством публикации и должно иметь то же значение, что и издатель.

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

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

Замечания

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

Если таблица MSreplication_subscriptions не существует на подписчике, sp_addpullsubscription создайте ее. Она также добавляет строку в таблицу MSreplication_subscriptions . Для подписок на вытягивание sp_addsubscription сначала следует вызывать на издателе.

Примеры

-- This script uses sqlcmd scripting variables. They are in the form
-- $(MyVariable). For information about how to use scripting variables  
-- on the command line and in SQL Server Management Studio, see the 
-- "Executing Replication Scripts" section in the topic
-- "Programming Replication Using System Stored Procedures".

-- Execute this batch at the Subscriber.
DECLARE @publication AS sysname;
DECLARE @publisher AS sysname;
DECLARE @publicationDB AS sysname;
SET @publication = N'AdvWorksProductTran';
SET @publisher = $(PubServer);
SET @publicationDB = N'AdventureWorks2022';

-- At the subscription database, create a pull subscription 
-- to a transactional publication.
USE [AdventureWorks2022Replica]
EXEC sp_addpullsubscription 
  @publisher = @publisher, 
  @publication = @publication, 
  @publisher_db = @publicationDB;

-- Add an agent job to synchronize the pull subscription.
EXEC sp_addpullsubscription_agent 
  @publisher = @publisher, 
  @publisher_db = @publicationDB, 
  @publication = @publication, 
  @distributor = @publisher, 
  @job_login = $(Login), 
  @job_password = $(Password);
GO

Разрешения

Могут выполняться только члены предопределенных ролей сервера sysadmin или db_owner предопределенных ролей базы данных.sp_addpullsubscription

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

• Create a Pull Subscription
• Create an Updatable Subscription to a Transactional Publication
• Subscribe to Publications
• sp_addpullsubscription_agent (Transact-SQL)
• sp_change_subscription_properties (Transact-SQL)
• sp_droppullsubscription (Transact-SQL)
• sp_helppullsubscription (Transact-SQL)
• sp_helpsubscription_properties (Transact-SQL)
• Системные хранимые процедуры (Transact-SQL)