sp_addpullsubscription (Transact-SQL)

適用対象: SQL Server Azure SQL Managed Instance

スナップショット パブリケーションまたはトランザクション パブリケーションにプル サブスクリプションを追加します。 このストアド プロシージャは、プル サブスクリプションが作成されるデータベース上のサブスクライバー側で実行されます。

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場合、パブリッシャー データベースとサブスクライバー データベースのペアごとに 1 つのディストリビューション エージェントがあります。

@independent_agent はパブリケーションのプロパティであり、パブリッシャーと同じ値を持つ必要があります。

[ @subscription_type = ] N'subscription_type'

サブスクリプションの種類。 @subscription_type は nvarchar(9) で、既定値は anonymous です。 パブリッシャーでサブスクリプションを登録せずにサブスクリプションを作成する場合を除き、@subscription_typeには pull の値を指定する必要があります。 この場合は、 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は bit で、既定値は 1 で、sp_addpublicationの@immediate_syncと同じ値に設定する必要があります。 @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)