プルサブスクリプションの作成

[アーティクル]
06/18/2013

このトピックでは、SQL Server 2012 で SQL Server Management Studio、Transact-SQL、またはレプリケーション管理オブジェクト (RMO) を使用してプルサブスクリプションを作成する方法について説明します。

P2P レプリケーションのプルサブスクリプションの設定にはスクリプトを使用できますが、ウィザードは使用できません。

このトピックの内容

プルサブスクリプションを作成するために使用するもの:

SQL Server Management Studio

Transact-SQL

レプリケーション管理オブジェクト (RMO)

SQL Server Management Studio の使用

サブスクリプションの新規作成ウィザードを使用して、パブリッシャーまたはサブスクライバーでプルサブスクリプションを作成します。ウィザードのページに従って、次の操作を実行します。

パブリッシャーとパブリケーションを指定します。
レプリケーションエージェントが実行される場所を選択します。プルサブスクリプションでは、パブリケーションの種類に応じて、[ディストリビューションエージェントの場所] ページまたは [マージエージェントの場所] ページで、[サブスクライバーで各エージェントを実行する (プルサブスクリプション)] を選択します。
サブスクライバーとサブスクリプションデータベースを指定します。
レプリケーションエージェントによって作成された接続に対して使用されるログインとパスワードを指定します。
- スナップショットパブリケーションとトランザクションパブリケーションに対するサブスクリプションでは、[ディストリビューションエージェントセキュリティ] ページで資格情報を指定します。
- マージパブリケーションに対するサブスクリプションでは、[マージエージェントセキュリティ] ページで資格情報を指定します。
各エージェントで必要な権限の詳細については、「レプリケーションエージェントのセキュリティモデル」を参照してください。
同期スケジュール、およびサブスクライバーをいつ初期化するかを指定します。
マージパブリケーションの追加オプションである、サブスクリプションの種類、パラメーター化されたフィルターの値、およびパブリケーションが Web 同期に対して有効になっている場合の HTTPS を使用した同期に関する情報を指定します。
サブスクリプションの更新が許可されるトランザクションパブリケーションの追加オプションを指定します。サブスクライバーがパブリッシャーで変更をすぐにコミットするかどうか、変更をキューに書き込むかどうか、およびサブスクライバーからパブリッシャーへの接続に使用される資格情報を指定します。
必要に応じて、サブスクリプションのスクリプトを作成します。

パブリッシャーからプルサブスクリプションを作成するには

Microsoft SQL Server Management Studio でパブリッシャーに接続し、サーバーノードを展開します。
[レプリケーション] フォルダーを展開し、[ローカルパブリケーション] フォルダーを展開します。
1 つ以上のサブスクリプションを作成するパブリケーションを右クリックし、[新しいサブスクリプション] をクリックします。
サブスクリプションの新規作成ウィザードのページに従って操作を実行します。

サブスクライバーからプルサブスクリプションを作成するには

SQL Server Management Studio でサブスクライバーに接続して、サーバーノードを展開します。
[レプリケーション] フォルダーを展開します。
[ローカルサブスクリプション] フォルダーを右クリックし、[新しいサブスクリプション] をクリックします。
サブスクリプションの新規作成ウィザードの [パブリケーション] ページで、[パブリッシャー] ボックスの一覧から [<パブリッシャーの検索.>] または [<Oracle パブリッシャーの検索>] を選択します。
[サーバーへの接続] ダイアログボックスでパブリッシャーに接続します。
[パブリケーション] ページでパブリケーションを選択します。
サブスクリプションの新規作成ウィザードのページに従って操作を実行します。

[トップに戻る] リンクで使用される矢印アイコン [先頭に戻る]

Transact-SQL の使用

レプリケーションストアドプロシージャを使用して、プルサブスクリプションをプログラムで作成できます。使用するストアドプロシージャは、サブスクリプションが属するパブリケーションの種類によって変わります。

スナップショットパブリケーションまたはトランザクションパブリケーションに対するプルサブスクリプションを作成するには

パブリッシャーで、sp_helppublication (Transact-SQL) を実行して、パブリケーションがプルサブスクリプションをサポートしていることを確認します。
- 結果セットの allow_pull の値が 1 である場合、パブリケーションはプルサブスクリプションをサポートします。
- allow_pull の値が 0 である場合は、@property に allow_pull を、@value に true を指定して、sp_changepublication (Transact-SQL) を実行します。
サブスクライバーで、sp_addpullsubscription (Transact-SQL) を実行します。 @publisher と @publication を指定します。サブスクリプションの更新の詳細については、「トランザクションパブリケーションの更新可能なサブスクリプションの作成」を参照してください。

サブスクライバーで、sp_addpullsubscription_agent (Transact-SQL) を実行します。次の指定を行います。

@publisher、@publisher_db、および @publication の各パラメーター。

@job_login および @job_password に、サブスクライバーでディストリビューションエージェントを実行するときに使用する Microsoft Windows 資格情報。

注
Windows 統合認証を使用して行われる接続では、常に @job_login および @job_password で指定された Windows 資格情報が使用されます。ディストリビューションエージェントは、常に Windows 統合認証を使用してサブスクライバーへのローカル接続を作成します。既定では、エージェントは Windows 統合認証を使用してディストリビューターに接続します。

Windows 統合認証を使用して行われる接続では、常に @job_login および @job_password で指定された Windows 資格情報が使用されます。ディストリビューションエージェントは、常に Windows 統合認証を使用してサブスクライバーへのローカル接続を作成します。既定では、エージェントは Windows 統合認証を使用してディストリビューターに接続します。

(省略可) ディストリビューターへの接続時に SQL Server 認証を使用する必要がある場合は、@distributor_security_mode に 0、@distributor_login および @distributor_password に Microsoft SQL Server ログイン情報。
このサブスクリプションでのディストリビューションエージェントジョブのスケジュール。詳細については、「同期スケジュールの指定」を参照してください。

パブリッシャーで、sp_addsubscription (Transact-SQL) を実行してプルサブスクリプションを登録します。 @publication、@subscriber、および @destination_db を指定します。 @subscription_type には pull を指定します。

マージパブリケーションに対するプルサブスクリプションを作成するには

パブリッシャーで、sp_helpmergepublication (Transact-SQL) を実行して、パブリケーションがプルサブスクリプションをサポートしていることを確認します。
- 結果セットの allow_pull の値が 1 である場合、パブリケーションはプルサブスクリプションをサポートします。
- allow_pull の値が 0 である場合は、@property に allow_pull を、@value に true を指定して、sp_changemergepublication (Transact-SQL) を実行します。
サブスクライバーで、sp_addmergepullsubscription (Transact-SQL) を実行します。 @publisher、@publisher_db、@publication、および次のパラメーターを指定します。
- @subscriber_type – クライアントサブスクリプションには local を指定し、サーバーサブスクリプションには global を指定します。
- @subscription_priority – サブスクリプションの優先度 (0.00 ～ 99.99) を指定します。これは、サーバーサブスクリプションにのみ必要です。
  
  詳細については、「マージレプリケーションの競合検出および解決の詳細」を参照してください。

サブスクライバーで、sp_addmergepullsubscription_agent (Transact-SQL) を実行します。次のパラメーターを指定します。

@publisher、@publisher_db、および @publication の各パラメーター。

@job_login および @job_password に、サブスクライバーでマージエージェントを実行するときに使用する Windows 資格情報。

注
Windows 統合認証を使用して行われる接続では、常に @job_login および @job_password で指定された Windows 資格情報が使用されます。マージエージェントは、常に Windows 統合認証を使用してサブスクライバーへのローカル接続を作成します。既定では、エージェントは Windows 統合認証を使用してディストリビューターおよびパブリッシャーに接続します。

Windows 統合認証を使用して行われる接続では、常に @job_login および @job_password で指定された Windows 資格情報が使用されます。マージエージェントは、常に Windows 統合認証を使用してサブスクライバーへのローカル接続を作成します。既定では、エージェントは Windows 統合認証を使用してディストリビューターおよびパブリッシャーに接続します。

(省略可) ディストリビューターへの接続時に SQL Server 認証を使用する必要がある場合は、@distributor_security_mode に 0、@distributor_login および @distributor_password に SQL Server ログイン情報。
(省略可) パブリッシャーへの接続時に SQL Server 認証を使用する必要がある場合は、@publisher_security_mode に 0、@publisher_login および @publisher_password に SQL Server ログイン情報。
このサブスクリプションでのマージエージェントジョブのスケジュール。詳細については、「トランザクションパブリケーションの更新可能なサブスクリプションの作成」を参照してください。

パブリッシャーで、sp_addmergesubscription (Transact-SQL) を実行します。 @publication、@subscriber、@subscriber_db を指定し、@subscription_type に pull を指定します。これにより、プルサブスクリプションが登録されます。

例 (Transact-SQL)

次の例では、トランザクションパブリケーションに対するプルサブスクリプションを作成します。最初のバッチはサブスクライバーで実行され、2 番目のバッチはパブリッシャーで実行されます。ログインとパスワードの値は、実行時に sqlcmd スクリプト変数を使用して入力されます。

-- 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'AdventureWorks2012';

-- At the subscription database, create a pull subscription 
-- to a transactional publication.
USE [AdventureWorks2012Replica]
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

-- 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 Publisher.
DECLARE @publication AS sysname;
DECLARE @subscriber AS sysname;
DECLARE @subscriptionDB AS sysname;
SET @publication = N'AdvWorksProductTran';
SET @subscriber = $(SubServer);
SET @subscriptionDB = N'AdventureWorks2012Replica';

-- At the Publisher, register the subscription, using the defaults.
EXEC sp_addsubscription 
  @publication = @publication, 
  @subscriber = @subscriber, 
  @destination_db = @subscriptionDB, 
  @subscription_type = N'pull',
  @status = N'subscribed';
GO

次の例では、マージパブリケーションに対するプルサブスクリプションを作成します。最初のバッチはサブスクライバーで実行され、2 番目のバッチはパブリッシャーで実行されます。ログインとパスワードの値は、実行時に sqlcmd スクリプト変数を使用して入力されます。

-- 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;
DECLARE @hostname AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge';
SET @publisher = $(PubServer);
SET @publicationDB = N'AdventureWorks2012';
SET @hostname = N'adventure-works\david8';

-- At the subscription database, create a pull subscription 
-- to a merge publication.
USE [AdventureWorks2012Replica]
EXEC sp_addmergepullsubscription 
  @publisher = @publisher, 
  @publication = @publication, 
  @publisher_db = @publicationDB;

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

-- Execute this batch at the Publisher.
DECLARE @myMergePub  AS sysname;
DECLARE @mySub       AS sysname;
DECLARE @mySubDB     AS sysname;

SET @myMergePub = N'AdvWorksSalesOrdersMerge';
SET @mySub = N'MYSUBSERVER';
SET @mySubDB = N'AdventureWorks2012Replica';

-- At the Publisher, register the subscription, using the defaults.
USE [AdventureWorks2012]
EXEC sp_addmergesubscription @publication = @myMergePub, 
@subscriber = @mySub, @subscriber_db = @mySubDB, 
@subscription_type = N'pull';
GO

[トップに戻る] リンクで使用される矢印アイコン [先頭に戻る]

レプリケーション管理オブジェクト (RMO) の使用

プルサブスクリプションの作成に使用する RMO のクラスは、サブスクリプションが属しているパブリケーションの種類によって異なります。

スナップショットパブリケーションまたはトランザクションパブリケーションに対するプルサブスクリプションを作成するには

ServerConnection クラスを使用して、サブスクライバーおよびパブリッシャーへの接続を作成します。
手順 1. のパブリッシャー接続を使用して、TransPublication クラスのインスタンスを作成します。 Name、DatabaseName、および ConnectionContext を指定します。
LoadProperties メソッドを呼び出します。このメソッドが false を返す場合、手順 2. で指定したプロパティが誤っているか、サーバーにパブリケーションが存在していません。
Attributes プロパティと AllowPull のビットごとの論理積演算 (Visual C# では &、Visual Basic では And) を実行します。結果が None の場合は、Attributes に対して、ビットごとの論理 OR ( |(Visual C#) および Or (Visual Basic)) を Attributes と AllowPull の間で実行した結果を設定します。続けて、CommitPropertyChanges を呼び出して、プルサブスクリプションを有効にします。
サブスクリプションデータベースが存在しない場合は、Database クラスを使用して作成します。詳細については、「データベースの作成、変更、および削除」を参照してください。
TransPullSubscription クラスのインスタンスを作成します。

次のサブスクリプションプロパティを設定します。

手順 1. で作成した、サブスクライバーに対する ServerConnection を ConnectionContext に指定します。
サブスクリプションデータベース名を DatabaseName に指定します。
パブリッシャー名を PublisherName に指定します。
パブリケーションデータベース名を PublicationDBName に指定します。
パブリケーション名を PublicationName に指定します。

サブスクライバーで実行されるディストリビューションエージェントが使用するための Microsoft Windows アカウントの資格情報を SynchronizationAgentProcessSecurity の Login フィールドおよび Password (または SecurePassword) フィールドに指定します。このアカウントは、サブスクライバーとのローカル接続を確立したり、Windows 認証を使用したリモート接続を確立するときに使用されます。

注
サブスクリプションが sysadmin 固定サーバーロールのメンバーにより作成される場合、SynchronizationAgentProcessSecurity の設定は必須ではありませんが、推奨されます。この場合、エージェントは SQL Server エージェントのアカウントを借用します。詳細については、「レプリケーションエージェントのセキュリティモデル」を参照してください。

サブスクリプションが sysadmin 固定サーバーロールのメンバーにより作成される場合、SynchronizationAgentProcessSecurity の設定は必須ではありませんが、推奨されます。この場合、エージェントは SQL Server エージェントのアカウントを借用します。詳細については、「レプリケーションエージェントのセキュリティモデル」を参照してください。

(省略可) サブスクリプションを同期するためのエージェントジョブを作成する場合は、CreateSyncAgentByDefault の値に true を指定します。 false (既定値) を指定した場合、サブスクリプションはプログラムによってのみ同期できます。また、このオブジェクトに SynchronizationAgent プロパティからアクセスする場合は、TransSynchronizationAgent のプロパティを別途指定する必要があります。詳細については、「プルサブスクリプションの同期」を参照してください。

注
SQL Server エージェントは、Microsoft SQL Server のすべてのエディションで使用できるわけではありません。 SQL Server の各エディションでサポートされる機能の一覧については、「SQL Server 2012 の各エディションがサポートする機能」を参照してください。 Express のサブスクライバーに対して値 true を指定しても、エージェントジョブは作成されません。ただし、サブスクリプション関連の重要なメタデータについてはサブスクライバーに保存されます。

SQL Server エージェントは、Microsoft SQL Server のすべてのエディションで使用できるわけではありません。 SQL Server の各エディションでサポートされる機能の一覧については、「SQL Server 2012 の各エディションがサポートする機能」を参照してください。 Express のサブスクライバーに対して値 true を指定しても、エージェントジョブは作成されません。ただし、サブスクリプション関連の重要なメタデータについてはサブスクライバーに保存されます。

(省略可) SQL Server 認証を使ってディストリビューターに接続する場合は、DistributorSecurity の SqlStandardLogin フィールドおよび SqlStandardPassword (または SecureSqlStandardPassword) フィールドを設定します。

Create メソッドを呼び出します。
手順 2. で作成した TransPublication クラスのインスタンスを使用して、MakePullSubscriptionWellKnown メソッドを呼び出し、パブリッシャーにプルサブスクリプションを登録します。既に登録されている場合は、例外が発生します。

マージパブリケーションに対するプルサブスクリプションを作成するには

ServerConnection クラスを使用して、サブスクライバーとパブリッシャーの両方に対する接続を作成します。
手順 1. のパブリッシャー接続を使用して、MergePublication クラスのインスタンスを作成します。 Name、DatabaseName、および ConnectionContext を指定します。
LoadProperties メソッドを呼び出します。このメソッドが false を返す場合、手順 2. で指定したプロパティが誤っているか、サーバーにパブリケーションが存在していません。
Attributes プロパティと AllowPull のビットごとの論理積演算 (Visual C# では &、Visual Basic では And) を実行します。結果が None の場合は、Attributes に対して、ビットごとの論理 OR ( |(Visual C#) および Or (Visual Basic)) を Attributes と AllowPull の間で実行した結果を設定します。続けて、CommitPropertyChanges を呼び出して、プルサブスクリプションを有効にします。
サブスクリプションデータベースが存在しない場合は、Database クラスを使用して作成します。詳細については、「データベースの作成、変更、および削除」を参照してください。
MergePullSubscription クラスのインスタンスを作成します。

次のサブスクリプションプロパティを設定します。

手順 1. で作成した、サブスクライバーに対する ServerConnection を ConnectionContext に指定します。
サブスクリプションデータベース名を DatabaseName に指定します。
パブリッシャー名を PublisherName に指定します。
パブリケーションデータベース名を PublicationDBName に指定します。
パブリケーション名を PublicationName に指定します。

サブスクライバーで実行されるマージエージェントが使用するための Microsoft Windows アカウントの資格情報を SynchronizationAgentProcessSecurity の Login フィールドおよび Password (または SecurePassword) フィールドに指定します。このアカウントは、サブスクライバーとのローカル接続を確立したり、Windows 認証を使用したリモート接続を確立するときに使用されます。

(省略可) サブスクリプションを同期するためのエージェントジョブを作成する場合は、CreateSyncAgentByDefault の値に true を指定します。 false (既定値) を指定した場合、サブスクリプションはプログラムによってのみ同期できます。また、このオブジェクトに SynchronizationAgent プロパティからアクセスする場合は、MergeSynchronizationAgent のプロパティを別途指定する必要があります。詳細については、「プルサブスクリプションの同期」を参照してください。
(省略可) SQL Server 認証を使ってディストリビューターに接続する場合は、DistributorSecurity の SqlStandardLogin フィールドおよび SqlStandardPassword (または SecureSqlStandardPassword) フィールドを設定します。
(省略可) SQL Server 認証を使用してパブリッシャーに接続する場合、PublisherSecurity の SqlStandardLogin フィールドおよび SqlStandardPassword (または SecureSqlStandardPassword) フィールドを設定します。

Create メソッドを呼び出します。
手順 2. で作成した MergePublication クラスのインスタンスを使用して、MakePullSubscriptionWellKnown メソッドを呼び出し、パブリッシャーにプルサブスクリプションを登録します。既に登録されている場合は、例外が発生します。

注
サブスクリプションが sysadmin 固定サーバーロールのメンバーにより作成される場合、SynchronizationAgentProcessSecurity の設定は必須ではありませんが、推奨されます。この場合、エージェントは SQL Server エージェントのアカウントを借用します。詳細については、「レプリケーションエージェントのセキュリティモデル」を参照してください。

例 (RMO)

次の例では、トランザクションパブリケーションに対するプルサブスクリプションを作成します。ディストリビューションエージェントジョブを作成するために使用する Microsoft Windows アカウントの資格情報は実行時に渡されます。

           // Define the Publisher, publication, and databases.
            string publicationName = "AdvWorksProductTran";
            string publisherName = publisherInstance;
            string subscriberName = subscriberInstance;
            string subscriptionDbName = "AdventureWorks2012Replica";
            string publicationDbName = "AdventureWorks2012";

            //Create connections to the Publisher and Subscriber.
            ServerConnection subscriberConn = new ServerConnection(subscriberName);
            ServerConnection publisherConn = new ServerConnection(publisherName);

            // Create the objects that we need.
            TransPublication publication;
            TransPullSubscription subscription;

            try
            {
                // Connect to the Publisher and Subscriber.
                subscriberConn.Connect();
                publisherConn.Connect();

                // Ensure that the publication exists and that 
                // it supports pull subscriptions.
                publication = new TransPublication();
                publication.Name = publicationName;
                publication.DatabaseName = publicationDbName;
                publication.ConnectionContext = publisherConn;

                if (publication.IsExistingObject)
                {
                    if ((publication.Attributes & PublicationAttributes.AllowPull) == 0)
                    {
                        publication.Attributes |= PublicationAttributes.AllowPull;
                    }

                    // Define the pull subscription.
                    subscription = new TransPullSubscription();
                    subscription.ConnectionContext = subscriberConn;
                    subscription.PublisherName = publisherName;
                    subscription.PublicationName = publicationName;
                    subscription.PublicationDBName = publicationDbName;
                    subscription.DatabaseName = subscriptionDbName;

                    // Specify the Windows login credentials for the Distribution Agent job.
                    subscription.SynchronizationAgentProcessSecurity.Login = winLogin;
                    subscription.SynchronizationAgentProcessSecurity.Password = winPassword;

                    // Make sure that the agent job for the subscription is created.
                    subscription.CreateSyncAgentByDefault = true;

                    // By default, subscriptions to transactional publications are synchronized 
                    // continuously, but in this case we only want to synchronize on demand.
                    subscription.AgentSchedule.FrequencyType = ScheduleFrequencyType.OnDemand;

                    // Create the pull subscription at the Subscriber.
                    subscription.Create();

                    Boolean registered = false;

                    // Verify that the subscription is not already registered.
                    foreach (TransSubscription existing
                        in publication.EnumSubscriptions())
                    {
                        if (existing.SubscriberName == subscriberName
                            && existing.SubscriptionDBName == subscriptionDbName)
                        {
                            registered = true;
                        }
                    }
                    if (!registered)
                    {
                        // Register the subscription with the Publisher.
                        publication.MakePullSubscriptionWellKnown(
                            subscriberName, subscriptionDbName,
                            SubscriptionSyncType.Automatic,
                            TransSubscriberType.ReadOnly);
                    }
                }
                else
                {
                    // Do something here if the publication does not exist.
                    throw new ApplicationException(String.Format(
                        "The publication '{0}' does not exist on {1}.",
                        publicationName, publisherName));
                }
            }
            catch (Exception ex)
            {
                // Implement the appropriate error handling here.
                throw new ApplicationException(String.Format(
                    "The subscription to {0} could not be created.", publicationName), ex);
            }
            finally
            {
                subscriberConn.Disconnect();
                publisherConn.Disconnect();
            }

' Define the Publisher, publication, and databases.
Dim publicationName As String = "AdvWorksProductTran"
Dim publisherName As String = publisherInstance
Dim subscriberName As String = subscriberInstance
Dim subscriptionDbName As String = "AdventureWorks2012Replica"
Dim publicationDbName As String = "AdventureWorks2012"

'Create connections to the Publisher and Subscriber.
Dim subscriberConn As ServerConnection = New ServerConnection(subscriberName)
Dim publisherConn As ServerConnection = New ServerConnection(publisherName)

' Create the objects that we need.
Dim publication As TransPublication
Dim subscription As TransPullSubscription

Try
    ' Connect to the Publisher and Subscriber.
    subscriberConn.Connect()
    publisherConn.Connect()

    ' Ensure that the publication exists and that 
    ' it supports pull subscriptions.
    publication = New TransPublication()
    publication.Name = publicationName
    publication.DatabaseName = publicationDbName
    publication.ConnectionContext = publisherConn

    If publication.IsExistingObject Then
        If (publication.Attributes And PublicationAttributes.AllowPull) = 0 Then
            publication.Attributes = publication.Attributes _
            Or PublicationAttributes.AllowPull
        End If

        ' Define the pull subscription.
        subscription = New TransPullSubscription()
        subscription.ConnectionContext = subscriberConn
        subscription.PublisherName = publisherName
        subscription.PublicationName = publicationName
        subscription.PublicationDBName = publicationDbName
        subscription.DatabaseName = subscriptionDbName
        subscription.Description = "Pull subscription to " + publicationDbName _
        + " on " + subscriberName + "."

        ' Specify the Windows login credentials for the Distribution Agent job.
        subscription.SynchronizationAgentProcessSecurity.Login = winLogin
        subscription.SynchronizationAgentProcessSecurity.Password = winPassword

        ' Make sure that the agent job for the subscription is created.
        subscription.CreateSyncAgentByDefault = True

        ' By default, subscriptions to transactional publications are synchronized 
        ' continuously, but in this case we only want to synchronize on demand.
        subscription.AgentSchedule.FrequencyType = ScheduleFrequencyType.OnDemand

        ' Create the pull subscription at the Subscriber.
        subscription.Create()

        Dim registered As Boolean = False

        ' Verify that the subscription is not already registered.
        For Each existing As TransSubscription In publication.EnumSubscriptions()
            If existing.SubscriberName = subscriberName And _
                existing.SubscriptionDBName = subscriptionDbName Then
                registered = True
            End If
        Next existing
        If Not registered Then
            ' Register the subscription with the Publisher.
            publication.MakePullSubscriptionWellKnown( _
             subscriberName, subscriptionDbName, _
             SubscriptionSyncType.Automatic, _
             TransSubscriberType.ReadOnly)
        End If
    Else
        ' Do something here if the publication does not exist.
        Throw New ApplicationException(String.Format( _
         "The publication '{0}' does not exist on {1}.", _
         publicationName, publisherName))
    End If
Catch ex As Exception
    ' Implement the appropriate error handling here.
    Throw New ApplicationException(String.Format( _
        "The subscription to {0} could not be created.", publicationName), ex)
Finally
    subscriberConn.Disconnect()
    publisherConn.Disconnect()
End Try

次の例では、マージパブリケーションに対するプルサブスクリプションを作成します。マージエージェントジョブを作成するために使用する Windows アカウントの資格情報は実行時に渡されます。

           // Define the Publisher, publication, and databases.
            string publicationName = "AdvWorksSalesOrdersMerge";
            string publisherName = publisherInstance;
            string subscriberName = subscriberInstance;
            string subscriptionDbName = "AdventureWorks2012Replica";
            string publicationDbName = "AdventureWorks2012";
            string hostname = @"adventure-works\garrett1";

            //Create connections to the Publisher and Subscriber.
            ServerConnection subscriberConn = new ServerConnection(subscriberName);
            ServerConnection publisherConn = new ServerConnection(publisherName);

            // Create the objects that we need.
            MergePublication publication;
            MergePullSubscription subscription;

            try
            {
                // Connect to the Subscriber.
                subscriberConn.Connect();

                // Ensure that the publication exists and that 
                // it supports pull subscriptions.
                publication = new MergePublication();
                publication.Name = publicationName;
                publication.DatabaseName = publicationDbName;
                publication.ConnectionContext = publisherConn;

                if (publication.LoadProperties())
                {
                    if ((publication.Attributes & PublicationAttributes.AllowPull) == 0)
                    {
                        publication.Attributes |= PublicationAttributes.AllowPull;
                    }

                    // Define the pull subscription.
                    subscription = new MergePullSubscription();
                    subscription.ConnectionContext = subscriberConn;
                    subscription.PublisherName = publisherName;
                    subscription.PublicationName = publicationName;
                    subscription.PublicationDBName = publicationDbName;
                    subscription.DatabaseName = subscriptionDbName;
                    subscription.HostName = hostname;

                    // Specify the Windows login credentials for the Merge Agent job.
                    subscription.SynchronizationAgentProcessSecurity.Login = winLogin;
                    subscription.SynchronizationAgentProcessSecurity.Password = winPassword;

                    // Make sure that the agent job for the subscription is created.
                    subscription.CreateSyncAgentByDefault = true;

                    // Create the pull subscription at the Subscriber.
                    subscription.Create();

                    Boolean registered = false;

                    // Verify that the subscription is not already registered.
                    foreach (MergeSubscription existing
                        in publication.EnumSubscriptions())
                    {
                        if (existing.SubscriberName == subscriberName
                            && existing.SubscriptionDBName == subscriptionDbName
                            && existing.SubscriptionType == SubscriptionOption.Pull)
                        {
                            registered = true;
                        }
                    }
                    if (!registered)
                    {
                        // Register the local subscription with the Publisher.
                        publication.MakePullSubscriptionWellKnown(
                            subscriberName, subscriptionDbName,
                            SubscriptionSyncType.Automatic,
                            MergeSubscriberType.Local, 0);
                    }
                }
                else
                {
                    // Do something here if the publication does not exist.
                    throw new ApplicationException(String.Format(
                        "The publication '{0}' does not exist on {1}.",
                        publicationName, publisherName));
                }
            }
            catch (Exception ex)
            {
                // Implement the appropriate error handling here.
                throw new ApplicationException(String.Format(
                    "The subscription to {0} could not be created.", publicationName), ex);
            }
            finally
            {
                subscriberConn.Disconnect();
                publisherConn.Disconnect();
            }

' Define the Publisher, publication, and databases.
Dim publicationName As String = "AdvWorksSalesOrdersMerge"
Dim publisherName As String = publisherInstance
Dim subscriberName As String = subscriberInstance
Dim subscriptionDbName As String = "AdventureWorks2012Replica"
Dim publicationDbName As String = "AdventureWorks2012"
Dim hostname As String = "adventure-works\garrett1"

'Create connections to the Publisher and Subscriber.
Dim subscriberConn As ServerConnection = New ServerConnection(subscriberName)
Dim publisherConn As ServerConnection = New ServerConnection(publisherName)

' Create the objects that we need.
Dim publication As MergePublication
Dim subscription As MergePullSubscription

Try
    ' Connect to the Subscriber.
    subscriberConn.Connect()

    ' Ensure that the publication exists and that 
    ' it supports pull subscriptions.
    publication = New MergePublication()
    publication.Name = publicationName
    publication.DatabaseName = publicationDbName
    publication.ConnectionContext = publisherConn

    If publication.LoadProperties() Then
        If (publication.Attributes And PublicationAttributes.AllowPull) = 0 Then
            publication.Attributes = publication.Attributes _
            Or PublicationAttributes.AllowPull
        End If

        ' Define the pull subscription.
        subscription = New MergePullSubscription()
        subscription.ConnectionContext = subscriberConn
        subscription.PublisherName = publisherName
        subscription.PublicationName = publicationName
        subscription.PublicationDBName = publicationDbName
        subscription.DatabaseName = subscriptionDbName
        subscription.HostName = hostname

        ' Specify the Windows login credentials for the Merge Agent job.
        subscription.SynchronizationAgentProcessSecurity.Login = winLogin
        subscription.SynchronizationAgentProcessSecurity.Password = winPassword

        ' Make sure that the agent job for the subscription is created.
        subscription.CreateSyncAgentByDefault = True

        ' Create the pull subscription at the Subscriber.
        subscription.Create()

        Dim registered As Boolean = False

        ' Verify that the subscription is not already registered.
        For Each existing As MergeSubscription In _
        publication.EnumSubscriptions()
            If existing.SubscriberName = subscriberName Then
                registered = True
            End If
        Next
        If Not registered Then
            ' Register the local subscription with the Publisher.
            publication.MakePullSubscriptionWellKnown( _
             subscriberName, subscriptionDbName, _
             SubscriptionSyncType.Automatic, _
             MergeSubscriberType.Local, 0)
        End If
    Else
        ' Do something here if the publication does not exist.
        Throw New ApplicationException(String.Format( _
         "The publication '{0}' does not exist on {1}.", _
         publicationName, publisherName))
    End If
Catch ex As Exception
    ' Implement the appropriate error handling here.
    Throw New ApplicationException(String.Format( _
        "The subscription to {0} could not be created.", publicationName), ex)
Finally
    subscriberConn.Disconnect()
    publisherConn.Disconnect()
End Try

次の例では、関連するエージェントジョブやサブスクリプションメタデータを MSsubscription_properties に作成せずに、マージパブリケーションに対するプルサブスクリプションを作成しています。マージエージェントジョブを作成するために使用する Windows アカウントの資格情報は実行時に渡されます。

            // Define the Publisher, publication, and databases.
            string publicationName = "AdvWorksSalesOrdersMerge";
            string publisherName = publisherInstance;
            string subscriberName = subscriberInstance;
            string subscriptionDbName = "AdventureWorks2012Replica";
            string publicationDbName = "AdventureWorks2012";

            //Create connections to the Publisher and Subscriber.
            ServerConnection subscriberConn = new ServerConnection(subscriberName);
            ServerConnection publisherConn = new ServerConnection(publisherName);

            // Create the objects that we need.
            MergePublication publication;
            MergePullSubscription subscription;

            try
            {
                // Connect to the Subscriber.
                subscriberConn.Connect();

                // Ensure that the publication exists and that 
                // it supports pull subscriptions.
                publication = new MergePublication();
                publication.Name = publicationName;
                publication.DatabaseName = publicationDbName;
                publication.ConnectionContext = publisherConn;

                if (publication.LoadProperties())
                {
                    if ((publication.Attributes & PublicationAttributes.AllowPull) == 0)
                    {
                        publication.Attributes |= PublicationAttributes.AllowPull;
                    }

                    // Define the pull subscription.
                    subscription = new MergePullSubscription();
                    subscription.ConnectionContext = subscriberConn;
                    subscription.PublisherName = publisherName;
                    subscription.PublicationName = publicationName;
                    subscription.PublicationDBName = publicationDbName;
                    subscription.DatabaseName = subscriptionDbName;

                    // Specify that an agent job not be created for this subscription. The
                    // subscription can only be synchronized by running the Merge Agent directly.
                    // Subscripition metadata stored in MSsubscription_properties will not
                    // be available and must be specified at run time.
                    subscription.CreateSyncAgentByDefault = false;

                    // Create the pull subscription at the Subscriber.
                    subscription.Create();

                    Boolean registered = false;

                    // Verify that the subscription is not already registered.
                    foreach (MergeSubscription existing
                        in publication.EnumSubscriptions())
                    {
                        if (existing.SubscriberName == subscriberName
                            && existing.SubscriptionDBName == subscriptionDbName
                            && existing.SubscriptionType == SubscriptionOption.Pull)
                        {
                            registered = true;
                        }
                    }
                    if (!registered)
                    {
                        // Register the local subscription with the Publisher.
                        publication.MakePullSubscriptionWellKnown(
                            subscriberName, subscriptionDbName,
                            SubscriptionSyncType.Automatic,
                            MergeSubscriberType.Local, 0);
                    }
                }
                else
                {
                    // Do something here if the publication does not exist.
                    throw new ApplicationException(String.Format(
                        "The publication '{0}' does not exist on {1}.",
                        publicationName, publisherName));
                }
            }
            catch (Exception ex)
            {
                // Implement the appropriate error handling here.
                throw new ApplicationException(String.Format(
                    "The subscription to {0} could not be created.", publicationName), ex);
            }
            finally
            {
                subscriberConn.Disconnect();
                publisherConn.Disconnect();
            }

' Define the Publisher, publication, and databases.
Dim publicationName As String = "AdvWorksSalesOrdersMerge"
Dim publisherName As String = publisherInstance
Dim subscriberName As String = subscriberInstance
Dim subscriptionDbName As String = "AdventureWorks2012Replica"
Dim publicationDbName As String = "AdventureWorks2012"

'Create connections to the Publisher and Subscriber.
Dim subscriberConn As ServerConnection = New ServerConnection(subscriberName)
Dim publisherConn As ServerConnection = New ServerConnection(publisherName)

' Create the objects that we need.
Dim publication As MergePublication
Dim subscription As MergePullSubscription

Try
    ' Connect to the Subscriber.
    subscriberConn.Connect()

    ' Ensure that the publication exists and that 
    ' it supports pull subscriptions.
    publication = New MergePublication()
    publication.Name = publicationName
    publication.DatabaseName = publicationDbName
    publication.ConnectionContext = publisherConn

    If publication.LoadProperties() Then
        If (publication.Attributes And PublicationAttributes.AllowPull) = 0 Then
            publication.Attributes = publication.Attributes _
            Or PublicationAttributes.AllowPull
        End If

        ' Define the pull subscription.
        subscription = New MergePullSubscription()
        subscription.ConnectionContext = subscriberConn
        subscription.PublisherName = publisherName
        subscription.PublicationName = publicationName
        subscription.PublicationDBName = publicationDbName
        subscription.DatabaseName = subscriptionDbName

        ' Specify that an agent job not be created for this subscription. The
        ' subscription can only be synchronized by running the Merge Agent directly.
        ' Subscripition metadata stored in MSsubscription_properties will not
        ' be available and must be specified at run time.
        subscription.CreateSyncAgentByDefault = False

        ' Create the pull subscription at the Subscriber.
        subscription.Create()

        Dim registered As Boolean = False

        ' Verify that the subscription is not already registered.
        For Each existing As MergeSubscription In _
        publication.EnumSubscriptions()
            If existing.SubscriberName = subscriberName Then
                registered = True
            End If
        Next
        If Not registered Then
            ' Register the local subscription with the Publisher.
            publication.MakePullSubscriptionWellKnown( _
             subscriberName, subscriptionDbName, _
             SubscriptionSyncType.Automatic, _
             MergeSubscriberType.Local, 0)
        End If
    Else
        ' Do something here if the publication does not exist.
        Throw New ApplicationException(String.Format( _
         "The publication '{0}' does not exist on {1}.", _
         publicationName, publisherName))
    End If
Catch ex As Exception
    ' Implement the appropriate error handling here.
    Throw New ApplicationException(String.Format( _
     "The subscription to {0} could not be created.", publicationName), ex)
Finally
    subscriberConn.Disconnect()
    publisherConn.Disconnect()
End Try

次の例では、Web 同期によるインターネットを介した同期が可能な、マージパブリケーションに対するプルサブスクリプションを作成しています。マージエージェントジョブを作成するために使用する Windows アカウントの資格情報は実行時に渡されます。詳細については、「Web 同期の構成」を参照してください。

         // Define the Publisher, publication, and databases.
            string publicationName = "AdvWorksSalesOrdersMerge";
            string publisherName = publisherInstance;
            string subscriberName = subscriberInstance;
            string subscriptionDbName = "AdventureWorks2012Replica";
            string publicationDbName = "AdventureWorks2012";
            string hostname = @"adventure-works\garrett1";
            string webSyncUrl = "https://" + publisherInstance + "/WebSync/replisapi.dll";

            //Create connections to the Publisher and Subscriber.
            ServerConnection subscriberConn = new ServerConnection(subscriberName);
            ServerConnection publisherConn = new ServerConnection(publisherName);

            // Create the objects that we need.
            MergePublication publication;
            MergePullSubscription subscription;

            try
            {
                // Connect to the Subscriber.
                subscriberConn.Connect();

                // Ensure that the publication exists and that 
                // it supports pull subscriptions and Web synchronization.
                publication = new MergePublication();
                publication.Name = publicationName;
                publication.DatabaseName = publicationDbName;
                publication.ConnectionContext = publisherConn;

                if (publication.LoadProperties())
                {
                    if ((publication.Attributes & PublicationAttributes.AllowPull) == 0)
                    {
                        publication.Attributes |= PublicationAttributes.AllowPull;
                    }
                    if ((publication.Attributes & PublicationAttributes.AllowWebSynchronization) == 0)
                    {
                        publication.Attributes |= PublicationAttributes.AllowWebSynchronization;
                    }

                    // Define the pull subscription.
                    subscription = new MergePullSubscription();
                    subscription.ConnectionContext = subscriberConn;
                    subscription.PublisherName = publisherName;
                    subscription.PublicationName = publicationName;
                    subscription.PublicationDBName = publicationDbName;
                    subscription.DatabaseName = subscriptionDbName;
                    subscription.HostName = hostname;

                    // Specify the Windows login credentials for the Merge Agent job.
                    subscription.SynchronizationAgentProcessSecurity.Login = winLogin;
                    subscription.SynchronizationAgentProcessSecurity.Password = winPassword;

                    // Enable Web synchronization.
                    subscription.UseWebSynchronization = true;
                    subscription.InternetUrl = webSyncUrl;

                    // Specify the same Windows credentials to use when connecting to the
                    // Web server using HTTPS Basic Authentication.
                    subscription.InternetSecurityMode = AuthenticationMethod.BasicAuthentication;
                    subscription.InternetLogin = winLogin;
                    subscription.InternetPassword = winPassword;

                    // Ensure that we create a job for this subscription.
                    subscription.CreateSyncAgentByDefault = true;

                    // Create the pull subscription at the Subscriber.
                    subscription.Create();

                    Boolean registered = false;

                    // Verify that the subscription is not already registered.
                    foreach (MergeSubscription existing
                        in publication.EnumSubscriptions())
                    {
                        if (existing.SubscriberName == subscriberName
                            && existing.SubscriptionDBName == subscriptionDbName
                            && existing.SubscriptionType == SubscriptionOption.Pull)
                        {
                            registered = true;
                        }
                    }
                    if (!registered)
                    {
                        // Register the local subscription with the Publisher.
                        publication.MakePullSubscriptionWellKnown(
                            subscriberName, subscriptionDbName,
                            SubscriptionSyncType.Automatic,
                            MergeSubscriberType.Local, 0);
                    }
                }
                else
                {
                    // Do something here if the publication does not exist.
                    throw new ApplicationException(String.Format(
                        "The publication '{0}' does not exist on {1}.",
                        publicationName, publisherName));
                }
            }
            catch (Exception ex)
            {
                // Implement the appropriate error handling here.
                throw new ApplicationException(String.Format(
                    "The subscription to {0} could not be created.", publicationName), ex);
            }
            finally
            {
                subscriberConn.Disconnect();
                publisherConn.Disconnect();
            }

' Define the Publisher, publication, and databases.
Dim publicationName As String = "AdvWorksSalesOrdersMerge"
Dim publisherName As String = publisherInstance
Dim subscriberName As String = subscriberInstance
Dim subscriptionDbName As String = "AdventureWorks2012Replica"
Dim publicationDbName As String = "AdventureWorks2012"
Dim hostname As String = "adventure-works\garrett1"
Dim webSyncUrl As String = "https://" + publisherInstance + "/WebSync/replisapi.dll"

'Create connections to the Publisher and Subscriber.
Dim subscriberConn As ServerConnection = New ServerConnection(subscriberName)
Dim publisherConn As ServerConnection = New ServerConnection(publisherName)

' Create the objects that we need.
Dim publication As MergePublication
Dim subscription As MergePullSubscription

Try
    ' Connect to the Subscriber.
    subscriberConn.Connect()

    ' Ensure that the publication exists and that 
    ' it supports pull subscriptions and Web synchronization.
    publication = New MergePublication()
    publication.Name = publicationName
    publication.DatabaseName = publicationDbName
    publication.ConnectionContext = publisherConn

    If publication.LoadProperties() Then
        If (publication.Attributes And PublicationAttributes.AllowPull) = 0 Then
            publication.Attributes = publication.Attributes _
            Or PublicationAttributes.AllowPull
        End If
        If (publication.Attributes And PublicationAttributes.AllowWebSynchronization) = 0 Then
            publication.Attributes = publication.Attributes _
            Or PublicationAttributes.AllowWebSynchronization
        End If

        ' Define the pull subscription.
        subscription = New MergePullSubscription()
        subscription.ConnectionContext = subscriberConn
        subscription.PublisherName = publisherName
        subscription.PublicationName = publicationName
        subscription.PublicationDBName = publicationDbName
        subscription.DatabaseName = subscriptionDbName
        subscription.HostName = hostname
        subscription.CreateSyncAgentByDefault = True

        ' Specify the Windows login credentials for the Merge Agent job.
        subscription.SynchronizationAgentProcessSecurity.Login = winLogin
        subscription.SynchronizationAgentProcessSecurity.Password = winPassword

        ' Enable Web synchronization.
        subscription.UseWebSynchronization = True
        subscription.InternetUrl = webSyncUrl

        ' Specify the same Windows credentials to use when connecting to the
        ' Web server using HTTPS Basic Authentication.
        subscription.InternetSecurityMode = AuthenticationMethod.BasicAuthentication
        subscription.InternetLogin = winLogin
        subscription.InternetPassword = winPassword

        ' Create the pull subscription at the Subscriber.
        subscription.Create()

        Dim registered As Boolean = False

        ' Verify that the subscription is not already registered.
        For Each existing As MergeSubscription In _
        publication.EnumSubscriptions()
            If existing.SubscriberName = subscriberName Then
                registered = True
            End If
        Next
        If Not registered Then
            ' Register the local subscription with the Publisher.
            publication.MakePullSubscriptionWellKnown( _
             subscriberName, subscriptionDbName, _
             SubscriptionSyncType.Automatic, _
             MergeSubscriberType.Local, 0)
        End If
    Else
        ' Do something here if the publication does not exist.
        Throw New ApplicationException(String.Format( _
         "The publication '{0}' does not exist on {1}.", _
         publicationName, publisherName))
    End If
Catch ex As Exception
    ' Implement the appropriate error handling here.
    Throw New ApplicationException(String.Format( _
     "The subscription to {0} could not be created.", publicationName), ex)
Finally
    subscriberConn.Disconnect()
    publisherConn.Disconnect()
End Try

[トップに戻る] リンクで使用される矢印アイコン [先頭に戻る]

次の方法で共有

プルサブスクリプションの作成

SQL Server Management Studio の使用

パブリッシャーからプルサブスクリプションを作成するには

サブスクライバーからプルサブスクリプションを作成するには

Transact-SQL の使用

スナップショットパブリケーションまたはトランザクションパブリケーションに対するプルサブスクリプションを作成するには

マージパブリケーションに対するプルサブスクリプションを作成するには

例 (Transact-SQL)

レプリケーション管理オブジェクト (RMO) の使用

スナップショットパブリケーションまたはトランザクションパブリケーションに対するプルサブスクリプションを作成するには

マージパブリケーションに対するプルサブスクリプションを作成するには

例 (RMO)

関連項目

概念

その他のリソース

次の方法で共有

プル サブスクリプションの作成

SQL Server Management Studio の使用

パブリッシャーからプル サブスクリプションを作成するには

サブスクライバーからプル サブスクリプションを作成するには

Transact-SQL の使用

スナップショット パブリケーションまたはトランザクション パブリケーションに対するプル サブスクリプションを作成するには

マージ パブリケーションに対するプル サブスクリプションを作成するには

例 (Transact-SQL)

レプリケーション管理オブジェクト (RMO) の使用

スナップショット パブリケーションまたはトランザクション パブリケーションに対するプル サブスクリプションを作成するには

マージ パブリケーションに対するプル サブスクリプションを作成するには

例 (RMO)

関連項目

概念

その他のリソース

プルサブスクリプションの作成

パブリッシャーからプルサブスクリプションを作成するには

サブスクライバーからプルサブスクリプションを作成するには

スナップショットパブリケーションまたはトランザクションパブリケーションに対するプルサブスクリプションを作成するには

マージパブリケーションに対するプルサブスクリプションを作成するには

スナップショットパブリケーションまたはトランザクションパブリケーションに対するプルサブスクリプションを作成するには

マージパブリケーションに対するプルサブスクリプションを作成するには