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

[アーティクル]
09/25/2024

適用対象: SQL Server Azure SQL Managed Instance

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

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

SQL Server Management Studio を使用する

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

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

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

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

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

SQL Server Management Studio でサブスクライバ―に接続し、サーバーノードを展開します。
[レプリケーション] フォルダーを展開します。
[ローカルサブスクリプション] フォルダーを右クリックし、 [新しいサブスクリプション]をクリックします。
サブスクリプションの新規作成ウィザードの [パブリケーション] ページで、[パブリッシャー] ドロップボックスの一覧から [<SQL Server パブリッシャーの検索]> または [<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 資格情報。
  
  Note
  
  Windows 統合認証を使用して行われる接続では、常に @job_login および @job_passwordで指定された Windows 資格情報が使用されます。ディストリビューションエージェントは、常に Windows 統合認証を使用してサブスクライバーへのローカル接続を作成します。既定では、エージェントは Windows 統合認証を使用してディストリビューターに接続します。
- (省略可) ディストリビューターへの接続時に SQL Server 認証を使用する必要がある場合は、@distributor_security_mode に 0、@distributor_login および @distributor_password に SQL Server ログイン情報。
- このサブスクリプションでのディストリビューションエージェントジョブのスケジュール。詳細については、「 Specify Synchronization Schedules」を参照してください。
パブリッシャー側で 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 資格情報。
  
  Note
  
  Windows 統合認証を使用して行われる接続では、常に @job_login および @job_passwordで指定された Windows 資格情報が使用されます。マージエージェントは、常に Windows 統合認証を使用してサブスクライバーへのローカル接続を作成します。既定では、エージェントは Windows 統合認証を使用してディストリビューターおよびパブリッシャーに接続します。
- (省略可) ディストリビューターへの接続時に SQL Server 認証を使用する必要がある場合は、@distributor_security_mode に 0、@distributor_login および @distributor_password に 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'AdventureWorks';  
  
-- At the subscription database, create a pull subscription   
-- to a transactional publication.  
USE [AdventureWorksReplica]  
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'AdventureWorksReplica';  
  
-- 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'AdventureWorks';  
SET @hostname = N'adventure-works\david8';  
  
-- At the subscription database, create a pull subscription   
-- to a merge publication.  
USE [AdventureWorksReplica]  
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'AdventureWorksReplica';  
  
-- At the Publisher, register the subscription, using the defaults.  
USE [AdventureWorks]  
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 のビットごとの論理 AND 演算 (Visual C# では &、Visual Basic では And) を実行します。結果が Noneの場合、 Attributes と| プロパティと Or 、Visual Basic では Attributes に AllowPull」を参照してください。続けて、 CommitPropertyChanges を呼び出して、プルサブスクリプションを有効にします。
サブスクリプションデータベースが存在しない場合は、 Database クラスを使用して作成します。詳細については、「データベースの作成、変更、および削除」を参照してください。
TransPullSubscription クラスのインスタンスを作成します。
次のサブスクリプションプロパティを設定します。
- 手順 1. で作成した、サブスクライバーに対する ServerConnection を ConnectionContextに指定します。
- サブスクリプションデータベース名を DatabaseNameに指定します。
- パブリッシャー名を PublisherNameに指定します。
- パブリケーションデータベース名を PublicationDBNameに指定します。
- パブリケーション名を PublicationNameに指定します。
- サブスクライバーで実行されるディストリビューションエージェントが使用するための Microsoft Windows アカウントの資格情報を SynchronizationAgentProcessSecurity の Login および Password フィールドに指定します。このアカウントは、サブスクライバーとのローカル接続を確立したり、Windows 認証を使用したリモート接続を確立するときに使用されます。
  
  Note
  
  サブスクリプションが SynchronizationAgentProcessSecurity 固定サーバーロールのメンバーにより作成される場合、 P:Microsoft.SqlServer.Replication.PullSubscription.SynchronizationAgentProcessSecurity の設定は必須ではありませんが、推奨されます。この場合、エージェントは SQL Server エージェントのアカウントを借用します。詳細については、「レプリケーションエージェントセキュリティモデル」を参照してください。
- (省略可) ディストリビューターへの接続時に true allow_pull CreateSyncAgentByDefault を指定します。 false (既定値) を指定した場合、サブスクリプションはプログラムによってのみ同期できます。また、このオブジェクトに SynchronizationAgent プロパティからアクセスする場合は、TransSynchronizationAgent のプロパティを別途指定する必要があります。詳細については、「 Synchronize a Pull Subscription」をご覧ください。
  
  Note
  
  SQL Server エージェントは、Microsoft SQL Server のすべてのエディションで使用できるわけではありません。 SQL Server の各エディションでサポートされる機能の一覧については、「SQL Server 2022 の各エディションとサポートされている機能」を参照してください。 Express のサブスクライバーに対して値 true を指定しても、エージェントジョブは作成されません。ただし、サブスクリプション関連の重要なメタデータについてはサブスクライバーに保存されます。
- (省略可) SQL Server 認証を使ってディストリビューターに接続する場合は、 SqlStandardLogin の SqlStandardPassword フィールドおよび SecureSqlStandardPassword (または DistributorSecurity ) フィールドを設定します。
Create メソッドを呼び出します。
手順 2. で作成した TransPublication クラスのインスタンスを使用して、 MakePullSubscriptionWellKnown メソッドを呼び出し、パブリッシャーにプルサブスクリプションを登録します。既に登録されている場合は、例外が発生します。

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

ServerConnection クラスを使用して、サブスクライバーとパブリッシャーの両方に対する接続を作成します。
手順 1. のパブリッシャー接続を使用して、 MergePublication クラスのインスタンスを作成します。 Name、 DatabaseName、および ConnectionContextを指定します。
LoadProperties メソッドを呼び出します。このメソッドが falseを返す場合、手順 2. で指定したプロパティが誤っているか、サーバーにパブリケーションが存在していません。
Attributes プロパティと AllowPull のビットごとの論理 AND 演算 (Visual C# では &、Visual Basic では And) を実行します。結果が Noneの場合、 Attributes と| プロパティと Or 、Visual Basic では Attributes に AllowPull」を参照してください。続けて、 CommitPropertyChanges を呼び出して、プルサブスクリプションを有効にします。
サブスクリプションデータベースが存在しない場合は、 Database クラスを使用して作成します。詳細については、「データベースの作成、変更、および削除」を参照してください。
MergePullSubscription クラスのインスタンスを作成します。
次のサブスクリプションプロパティを設定します。
- 手順 1. で作成した、サブスクライバーに対する ServerConnection を ConnectionContextに指定します。
- サブスクリプションデータベース名を DatabaseNameに指定します。
- パブリッシャー名を PublisherNameに指定します。
- パブリケーションデータベース名を PublicationDBNameに指定します。
- パブリケーション名を PublicationNameに指定します。
- Login の Password および SynchronizationAgentProcessSecurity のフィールドは、マージエージェントがサスクライバーで実行する Microsoft Windows のアカウントに対して資格情報を提供します。このアカウントは、サブスクライバーとのローカル接続を確立したり、Windows 認証を使用したリモート接続を確立するときに使用されます。
  
  Note
  
  サブスクリプションが SynchronizationAgentProcessSecurity 固定サーバーロールのメンバーにより作成される場合、 P:Microsoft.SqlServer.Replication.PullSubscription.SynchronizationAgentProcessSecurity の設定は必須ではありませんが、推奨されます。この場合、エージェントは SQL Server エージェントのアカウントを借用します。詳細については、「レプリケーションエージェントセキュリティモデル」を参照してください。
- (省略可) ディストリビューターへの接続時に true allow_pull CreateSyncAgentByDefault を指定します。 false (既定値) を指定した場合、サブスクリプションはプログラムによってのみ同期できます。また、このオブジェクトに SynchronizationAgent プロパティからアクセスする場合は、MergeSynchronizationAgent のプロパティを別途指定する必要があります。詳細については、「 Synchronize a Pull Subscription」をご覧ください。
- (省略可) SQL Server 認証を使ってディストリビューターに接続する場合は、 SqlStandardLogin の SqlStandardPassword フィールドおよび SecureSqlStandardPassword (または DistributorSecurity ) フィールドを設定します。
- (省略可) SQL Server 認証を使用してパブリッシャーに接続する場合、 SqlStandardLogin の SqlStandardPassword フィールドおよび SecureSqlStandardPassword (または PublisherSecurity ) フィールドを設定します。
Create メソッドを呼び出します。
手順 2. で作成した MergePublication クラスのインスタンスを使用して、 MakePullSubscriptionWellKnown メソッドを呼び出し、パブリッシャーにプルサブスクリプションを登録します。既に登録されている場合は、例外が発生します。

例 (RMO)

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

// Define the Publisher, publication, and databases.  
string publicationName = "AdvWorksProductTran";  
string publisherName = publisherInstance;  
string subscriberName = subscriberInstance;  
string subscriptionDbName = "AdventureWorksReplica";  
string publicationDbName = "AdventureWorks";  
  
//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 = "AdventureWorksReplica"  
Dim publicationDbName As String = "AdventureWorks"  
  
'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 = "AdventureWorksReplica";  
string publicationDbName = "AdventureWorks";  
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 = "AdventureWorksReplica"  
Dim publicationDbName As String = "AdventureWorks"  
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 = "AdventureWorksReplica";  
string publicationDbName = "AdventureWorks";  
  
//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 = "AdventureWorksReplica"  
Dim publicationDbName As String = "AdventureWorks"  
  
'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 アカウントの資格情報は実行時に渡されます。詳しくは、「 Configure Web Synchronization」をご覧ください。

// Define the Publisher, publication, and databases.  
string publicationName = "AdvWorksSalesOrdersMerge";  
string publisherName = publisherInstance;  
string subscriberName = subscriberInstance;  
string subscriptionDbName = "AdventureWorksReplica";  
string publicationDbName = "AdventureWorks";  
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 = "AdventureWorksReplica"  
Dim publicationDbName As String = "AdventureWorks"  
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)

関連するコンテンツ

フィードバック

その他のリソース

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

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

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

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

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

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

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