サブスクリプションの再初期化

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

このトピックでは、SQL Server Management Studio、Transact-SQL、またはレプリケーション管理オブジェクト (RMO) を使用して、SQL Server でサブスクリプションを再初期化する方法について説明します。次回の同期で新しいスナップショットが適用されるように、個別のサブスクリプションに再初期化のマークを付けることができます。

Note

Azure SQL Managed Instance は、スナップショットおよびトランザクションレプリケーションのパブリッシャー、ディストリビューター、およびサブスクライバーの可能性があります。 Azure SQL Database のデータベースは、スナップショットとトランザクションレプリケーションのプッシュサブスクライバーの可能性しかありません。詳細については、Azure SQL Database および Azure SQL Managed Instance を使用したトランザクションのレプリケーションに関するページを参照してください。

SQL Server Management Studio を使用する

サブスクリプションの再初期化には、2 段階の処理があります。

パブリケーションの単一のサブスクリプションまたはすべてのサブスクリプションが再初期化対象として マーク されます。 [サブスクリプションの再初期化] ダイアログボックスでサブスクリプションを再初期化するように設定すします。このダイアログボックスは、Microsoft SQL Server Management Studio の [ローカルパブリケーション] フォルダーおよび [ローカルサブスクリプション] フォルダーから使用できます。また、 [すべてのサブスクリプション] タブやレプリケーションモニターのパブリケーションノードからマークを設定することもできます。レプリケーションモニターの起動の詳細については、「Start the Replication Monitor」 (レプリケーションモニターの開始) を参照してください。サブスクリプションの再初期化の設定には、以下のオプションがあります。

[現在のスナップショットを使用する]
このオプションを選択すると、次にディストリビューションエージェントまたはマージエージェントが実行されたときに、現在のスナップショットがサブスクライバーに適用されます。有効なスナップショットが使用できない場合、このオプションは選択できません。

[新しいスナップショットを使用する]
このオプションを選択すると、新しいスナップショットによってサブスクリプションが再初期化されます。スナップショットは、スナップショットエージェントによって生成された後にだけ、サブスクライバーに適用できます。スナップショットがスケジュールに従って実行されるように設定している場合は、スナップショットエージェントが次回実行されて終了するまでサブスクリプションを再初期化できません。スナップショットエージェントをすぐに開始するには、 [今すぐ新しいスナップショットを生成する] を選択します。

[再初期化する前に、同期されていない変更をアップロード]
マージレプリケーションのみです。このオプションを選択すると、サブスクライバーのデータがスナップショットで上書きされる前に、保留中の変更がサブスクリプションデータベースからアップロードされます。

パラメーター化フィルターを追加、削除、変更する場合は、再初期化の際、サブスクライバーで保留中の変更をパブリッシャーにアップロードできません。保留中の変更をアップロードしたい場合は、フィルターを変更する前にすべてのサブスクリプションを同期してください。
サブスクリプションは、次回同期されるときに再初期化されます。ディストリビューションエージェント (トランザクションレプリケーションの場合) またはマージエージェント (マージレプリケーションの場合) により、再初期化するように設定されている各サブスクライバーに最新のスナップショットが適用されます。サブスクリプションの同期の詳細については、「 Synchronize a Push Subscription 」および「 Synchronize a Pull Subscriptionダイアログボックスを使用します。

Management Studio で単一のプッシュサブスクリプションまたはプルサブスクリプションに再初期化を設定するには (パブリッシャーで実行)

Management Studio でパブリッシャーに接続し、サーバーノードを展開します。
[レプリケーション] フォルダーを展開し、 [ローカルパブリケーション] フォルダーを展開します。
再初期化するサブスクリプションが含まれているパブリケーションを展開します。
サブスクリプションを右クリックし、 [再初期化]をクリックします。
[サブスクリプションの再初期化] ダイアログボックスでオプションを選択し、 [再初期化するように設定]をクリックします。

Management Studio で単一のプルサブスクリプションに再初期化を設定するには (サブスクライバーで実行)

Management Studio でサブスクライバ―に接続し、サーバーノードを展開します。
[レプリケーション] フォルダーを展開し、 [ローカルサブスクリプション] フォルダーを展開します。
サブスクリプションを右クリックし、 [再初期化]をクリックします。
表示される確認のダイアログボックスで、 [はい]をクリックします。

Management Studio ですべてのサブスクリプションに再初期化を設定するには

Management Studio でパブリッシャーに接続し、サーバーノードを展開します。
[レプリケーション] フォルダーを展開し、 [ローカルパブリケーション] フォルダーを展開します。
サブスクリプションを再初期化するパブリケーションを右クリックし、 [すべてのサブスクリプションの再初期化]をクリックします。
[サブスクリプションの再初期化] ダイアログボックスでオプションを選択し、 [再初期化するように設定]をクリックします。

レプリケーションモニターで単一のプッシュサブスクリプションまたはプルサブスクリプションに再初期化を設定するには

レプリケーションモニターで、左ペインのパブリッシャーグループを展開し、パブリッシャーを展開してパブリケーションをクリックします。
[すべてのサブスクリプション] タブをクリックします。
再初期化するサブスクリプションを右クリックし、 [サブスクリプションの再初期化]をクリックします。
[サブスクリプションの再初期化] ダイアログボックスでオプションを選択し、 [再初期化するように設定]をクリックします。

レプリケーションモニターですべてのサブスクリプションに再初期化を設定するには

レプリケーションモニターの左ペインでパブリッシャーグループを展開し、パブリッシャーを展開します。
サブスクリプションを再初期化するパブリケーションを右クリックし、 [すべてのサブスクリプションの再初期化]をクリックします。
[サブスクリプションの再初期化] ダイアログボックスでオプションを選択し、 [再初期化するように設定]をクリックします。

Transact-SQL の使用

サブスクリプションは、プログラムでレプリケーションストアドプロシージャを使用して再初期化できます。使用するストアドプロシージャは、サブスクリプションの種類 (プッシュまたはプル) およびサブスクリプションが属しているパブリケーションの種類によって変わります。

トランザクションパブリケーションに対するプルサブスクリプションを再初期化するには

サブスクライバー側のサブスクリプションデータベースに対して、sp_reinitpullsubscription (Transact-SQL) を実行します。 @publisher、 @publisher_db、および @publicationを指定します。これにより、ディストリビューションエージェントの次回実行時に再初期化するようにサブスクリプションにマークが付けられます。
(省略可) サブスクライバーでディストリビューションエージェントを起動し、サブスクリプションを同期します。詳細については、「 Synchronize a Pull Subscription」をご覧ください。

トランザクションパブリケーションに対するプッシュサブスクリプションを再初期化するには

パブリッシャーで、sp_reinitsubscription (Transact-SQL) を実行します。 @publication、 @subscriber、および @destination_dbを指定します。これにより、ディストリビューションエージェントの次回実行時に再初期化するようにサブスクリプションにマークが付けられます。
(省略可) ディストリビューターでディストリビューションエージェントを起動し、サブスクリプションを同期します。詳細については、「プッシュサブスクリプションの同期」をご覧ください。

マージパブリケーションに対するプルサブスクリプションを再初期化するには

サブスクライバー側のサブスクリプションデータベースに対して、sp_reinitmergepullsubscription (Transact-SQL) を実行します。 @publisher、 @publisher_db、および @publicationを指定します。再初期化が実行される前にサブスクライバーの変更をアップロードする場合は、 @upload_first に trueを指定します。これにより、マージエージェントの次回実行時に再初期化するようにサブスクリプションにマークが付けられます。

重要

パラメーター化フィルターを追加、削除、変更する場合は、再初期化の際、サブスクライバーで保留中の変更をパブリッシャーにアップロードできません。保留中の変更をアップロードしたい場合は、フィルターを変更する前にすべてのサブスクリプションを同期してください。
(省略可) サブスクライバーでマージエージェントを起動し、サブスクリプションを同期します。詳細については、「 Synchronize a Pull Subscription」をご覧ください。

マージパブリケーションに対するプッシュサブスクリプションを再初期化するには

パブリッシャーで、sp_reinitmergesubscription (Transact-SQL) を実行します。 @publication、 @subscriber、および @subscriber_dbを指定します。再初期化が実行される前にサブスクライバーの変更をアップロードする場合は、 @upload_first に trueを指定します。これにより、ディストリビューションエージェントの次回実行時に再初期化するようにサブスクリプションにマークが付けられます。

重要

パラメーター化フィルターを追加、削除、変更する場合は、再初期化の際、サブスクライバーで保留中の変更をパブリッシャーにアップロードできません。保留中の変更をアップロードしたい場合は、フィルターを変更する前にすべてのサブスクリプションを同期してください。
(省略可) ディストリビューターでマージエージェントを起動し、サブスクリプションを同期します。詳細については、「プッシュサブスクリプションの同期」をご覧ください。

新しいマージパブリケーションを作成するときに再初期化ポリシーを設定するには

パブリッシャー側のパブリケーションデータベースで、 sp_addmergepublicationを実行し、次のいずれかの値を @automatic_reinitialization_policyに指定します。
- 1 - パブリケーションに対する変更に応じてサブスクリプションが自動的に再初期化される前に、サブスクライバーの変更がアップロードされます。
- 0 - パブリケーションに対する変更に応じてサブスクリプションが自動的に再初期化されるときに、サブスクライバーの変更は破棄されます。
重要

パラメーター化フィルターを追加、削除、変更する場合は、再初期化の際、サブスクライバーで保留中の変更をパブリッシャーにアップロードできません。保留中の変更をアップロードしたい場合は、フィルターを変更する前にすべてのサブスクリプションを同期してください。

詳しくは、「パブリケーションを作成」をご覧ください。

既存のマージパブリケーションの再初期化ポリシーを変更するには

パブリッシャー側のパブリケーションデータベースに対して sp_changemergepublicationを実行します。 @property に automatic_reinitialization_policy を指定し、次のいずれかの値を @valueに指定します。
- 1 - パブリケーションに対する変更に応じてサブスクリプションが自動的に再初期化される前に、サブスクライバーの変更がアップロードされます。
- 0 - パブリケーションに対する変更に応じてサブスクリプションが自動的に再初期化されるときに、サブスクライバーの変更は破棄されます。
重要

パラメーター化フィルターを追加、削除、変更する場合は、再初期化の際、サブスクライバーで保留中の変更をパブリッシャーにアップロードできません。保留中の変更をアップロードしたい場合は、フィルターを変更する前にすべてのサブスクリプションを同期してください。

詳しくは、「 View and Modify Publication Properties」をご覧ください。

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

次回の同期で新しいスナップショットが適用されるように、個別のサブスクリプションに再初期化のマークを付けることができます。レプリケーション管理オブジェクト (RMO) を使用することで、プログラムによってサブスクリプションを再初期化できます。使用するクラスは、サブスクリプションが属するパブリケーションの種類と、サブスクリプションの種類 (プッシュサブスクリプションまたはプルサブスクリプション) に応じて変わります。

トランザクションパブリケーションに対するプルサブスクリプションを再初期化するには

ServerConnection クラスを使用して、サブスクライバーへの接続を作成します。
TransPullSubscription クラスのインスタンスを作成し、 PublicationName、 DatabaseName、 PublisherName、 PublicationDBNameを設定して、手順 1. の接続を ConnectionContextに設定します。
LoadProperties メソッドを呼び出して、オブジェクトのプロパティを取得します。

Note

このメソッドが falseを返す場合、手順 2. でサブスクリプションプロパティを不適切に設定したか、プルサブスクリプションが存在していません。
Reinitialize メソッドを呼び出します。このメソッドにより、サブスクリプションを再初期化するようにマークされます。
プルサブスクリプションを同期します。詳細については、「 Synchronize a Pull Subscription」をご覧ください。

トランザクションパブリケーションに対するプッシュサブスクリプションを再初期化するには

ServerConnection クラスを使用して、パブリッシャーへの接続を作成します。
TransSubscription クラスのインスタンスを作成し、 PublicationName、 DatabaseName、 SubscriberName、 SubscriptionDBNameを設定して、手順 1. の接続を ConnectionContextに設定します。
LoadProperties メソッドを呼び出して、オブジェクトのプロパティを取得します。

Note

このメソッドが falseを返す場合、手順 2. でサブスクリプションプロパティを不適切に設定したか、プッシュサブスクリプションが存在していません。
Reinitialize メソッドを呼び出します。このメソッドにより、サブスクリプションを再初期化するようにマークされます。
プッシュサブスクリプションを同期します。詳細については、「プッシュサブスクリプションの同期」をご覧ください。

マージパブリケーションに対するプルサブスクリプションを再初期化するには

ServerConnection クラスを使用して、サブスクライバーへの接続を作成します。
MergePullSubscription クラスのインスタンスを作成し、 PublicationName、 DatabaseName、 PublisherName、 PublicationDBNameを設定して、手順 1. の接続を ConnectionContextに設定します。
LoadProperties メソッドを呼び出して、オブジェクトのプロパティを取得します。

Note

このメソッドが falseを返す場合、手順 2. でサブスクリプションプロパティを不適切に設定したか、プルサブスクリプションが存在していません。
Reinitialize メソッドを呼び出します。再初期化の前に true を渡してサブスクライバーの変更をアップロードするか、 false を渡して再初期化し、サブスクライバーの保留中の変更をすべて破棄します。このメソッドにより、サブスクリプションを再初期化するようにマークされます。

Note

サブスクリプションの有効期限が切れると、変更をアップロードできません。詳しくは、「 Set the Expiration Period for Subscriptions」をご覧ください。
プルサブスクリプションを同期します。詳細については、「 Synchronize a Pull Subscription」をご覧ください。

マージパブリケーションに対するプッシュサブスクリプションを再初期化するには

ServerConnection クラスを使用して、パブリッシャーへの接続を作成します。
MergeSubscription クラスのインスタンスを作成し、 PublicationName、 DatabaseName、 SubscriberName、 SubscriptionDBNameを設定して、手順 1. の接続を ConnectionContextに設定します。
LoadProperties メソッドを呼び出して、オブジェクトのプロパティを取得します。

Note

このメソッドが falseを返す場合、手順 2. でサブスクリプションプロパティを不適切に設定したか、プッシュサブスクリプションが存在していません。
Reinitialize メソッドを呼び出します。再初期化の前に true を渡してサブスクライバーの変更をアップロードするか、 false を渡して再初期化し、サブスクライバーの保留中の変更をすべて破棄します。このメソッドにより、サブスクリプションを再初期化するようにマークされます。

Note

サブスクリプションの有効期限が切れると、変更をアップロードできません。詳しくは、「 Set the Expiration Period for Subscriptions」をご覧ください。
プッシュサブスクリプションを同期します。詳細については、「プッシュサブスクリプションの同期」をご覧ください。

例 (RMO)

次の例では、トランザクションパブリケーションに対するプルサブスクリプションを再初期化します。

// Define server, publication, and database names.
String subscriberName = subscriberInstance;
String publisherName = publisherInstance;
String publicationName = "AdvWorksProductTran";
String publicationDbName = "AdventureWorks2022";
String subscriptionDbName = "AdventureWorks2022Replica";

// Create a connection to the Subscriber.
ServerConnection conn = new ServerConnection(subscriberName);

TransPullSubscription subscription;

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

    // Define subscription properties.
    subscription = new TransPullSubscription();
    subscription.ConnectionContext = conn;
    subscription.DatabaseName = subscriptionDbName;
    subscription.PublisherName = publisherName;
    subscription.PublicationDBName = publicationDbName;
    subscription.PublicationName = publicationName;

    // If the pull subscription and the job exists, mark the subscription
    // for reinitialization and start the agent job.
    if (subscription.LoadProperties() && subscription.AgentJobId != null)
    {
        subscription.Reinitialize();
        subscription.SynchronizeWithJob();
    }
    else
    {
        // Do something here if the subscription does not exist.
        throw new ApplicationException(String.Format(
            "A subscription to '{0}' does not exists on {1}",
            publicationName, subscriberName));
    }
}
catch (Exception ex)
{
    // Do appropriate error handling here.
    throw new ApplicationException("The subscription could not be reinitialized.", ex);
}
finally
{
    conn.Disconnect();
}

' Define server, publication, and database names.
Dim subscriberName As String = subscriberInstance
Dim publisherName As String = publisherInstance
Dim publicationName As String = "AdvWorksProductTran"
Dim publicationDbName As String = "AdventureWorks2022"
Dim subscriptionDbName As String = "AdventureWorks2022Replica"

' Create a connection to the Subscriber.
Dim conn As ServerConnection = New ServerConnection(subscriberName)

Dim subscription As TransPullSubscription

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

    ' Define subscription properties.
    subscription = New TransPullSubscription()
    subscription.ConnectionContext = conn
    subscription.DatabaseName = subscriptionDbName
    subscription.PublisherName = publisherName
    subscription.PublicationDBName = publicationDbName
    subscription.PublicationName = publicationName

    ' If the pull subscription and the job exists, mark the subscription
    ' for reinitialization and start the agent job.
    If subscription.LoadProperties() And (Not subscription.AgentJobId Is Nothing) Then
        subscription.Reinitialize()
        subscription.SynchronizeWithJob()
    Else
        ' Do something here if the subscription does not exist.
        Throw New ApplicationException(String.Format( _
         "A subscription to '{0}' does not exists on {1}", _
         publicationName, subscriberName))
    End If
Catch ex As Exception
    ' Do appropriate error handling here.
    Throw New ApplicationException("The subscription could not be reinitialized.", ex)
Finally
    conn.Disconnect()
End Try

次の例では、最初にサブスクライバーの保留中の変更をアップロードした後、マージパブリケーションに対するプルサブスクリプションを初期化します。

// Define server, publication, and database names.
String subscriberName = subscriberInstance;
String publisherName = publisherInstance;
String publicationName = "AdvWorksSalesOrdersMerge";
String publicationDbName = "AdventureWorks2022";
String subscriptionDbName = "AdventureWorks2022Replica";

// Create a connection to the Subscriber.
ServerConnection conn = new ServerConnection(subscriberName);

MergePullSubscription subscription;

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

    // Define subscription properties.
    subscription = new MergePullSubscription();
    subscription.ConnectionContext = conn;
    subscription.DatabaseName = subscriptionDbName;
    subscription.PublisherName = publisherName;
    subscription.PublicationDBName = publicationDbName;
    subscription.PublicationName = publicationName;

    // If the pull subscription and the job exists, mark the subscription
    // for reinitialization after upload and start the agent job.
    if (subscription.LoadProperties() && subscription.AgentJobId != null)
    {
        subscription.Reinitialize(true);
        subscription.SynchronizeWithJob();
    }
    else
    {
        // Do something here if the subscription does not exist.
        throw new ApplicationException(String.Format(
            "A subscription to '{0}' does not exists on {1}",
            publicationName, subscriberName));
    }
}
catch (Exception ex)
{
    // Do appropriate error handling here.
    throw new ApplicationException("The subscription could not be synchronized.", ex);
}
finally
{
    conn.Disconnect();
}

' Define server, publication, and database names.
Dim subscriberName As String = subscriberInstance
Dim publisherName As String = publisherInstance
Dim publicationName As String = "AdvWorksSalesOrdersMerge"
Dim publicationDbName As String = "AdventureWorks2022"
Dim subscriptionDbName As String = "AdventureWorks2022Replica"

' Create a connection to the Subscriber.
Dim conn As ServerConnection = New ServerConnection(subscriberName)

Dim subscription As MergePullSubscription

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

    ' Define subscription properties.
    subscription = New MergePullSubscription()
    subscription.ConnectionContext = conn
    subscription.DatabaseName = subscriptionDbName
    subscription.PublisherName = publisherName
    subscription.PublicationDBName = publicationDbName
    subscription.PublicationName = publicationName

    ' If the pull subscription and the job exists, mark the subscription
    ' for reinitialization after upload and start the agent job.
    If subscription.LoadProperties() And (Not subscription.AgentJobId Is Nothing) Then
        subscription.Reinitialize(True)
        subscription.SynchronizeWithJob()
    Else
        ' Do something here if the subscription does not exist.
        Throw New ApplicationException(String.Format( _
         "A subscription to '{0}' does not exists on {1}", _
         publicationName, subscriberName))
    End If
Catch ex As Exception
    ' Do appropriate error handling here.
    Throw New ApplicationException("The subscription could not be synchronized.", ex)
Finally
    conn.Disconnect()
End Try

次の方法で共有

サブスクリプションの再初期化

SQL Server Management Studio を使用する

Management Studio で単一のプッシュサブスクリプションまたはプルサブスクリプションに再初期化を設定するには (パブリッシャーで実行)

Management Studio で単一のプルサブスクリプションに再初期化を設定するには (サブスクライバーで実行)

Management Studio ですべてのサブスクリプションに再初期化を設定するには

レプリケーションモニターで単一のプッシュサブスクリプションまたはプルサブスクリプションに再初期化を設定するには

レプリケーションモニターですべてのサブスクリプションに再初期化を設定するには

Transact-SQL の使用

トランザクションパブリケーションに対するプルサブスクリプションを再初期化するには

トランザクションパブリケーションに対するプッシュサブスクリプションを再初期化するには

マージパブリケーションに対するプルサブスクリプションを再初期化するには

マージパブリケーションに対するプッシュサブスクリプションを再初期化するには

新しいマージパブリケーションを作成するときに再初期化ポリシーを設定するには

既存のマージパブリケーションの再初期化ポリシーを変更するには

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

トランザクションパブリケーションに対するプルサブスクリプションを再初期化するには

トランザクションパブリケーションに対するプッシュサブスクリプションを再初期化するには

マージパブリケーションに対するプルサブスクリプションを再初期化するには

マージパブリケーションに対するプッシュサブスクリプションを再初期化するには

例 (RMO)

フィードバック

その他のリソース

次の方法で共有

サブスクリプションの再初期化

SQL Server Management Studio を使用する

Management Studio で単一のプッシュ サブスクリプションまたはプル サブスクリプションに再初期化を設定するには (パブリッシャーで実行)

Management Studio で単一のプル サブスクリプションに再初期化を設定するには (サブスクライバーで実行)

Management Studio ですべてのサブスクリプションに再初期化を設定するには

レプリケーション モニターで単一のプッシュ サブスクリプションまたはプル サブスクリプションに再初期化を設定するには

レプリケーション モニターですべてのサブスクリプションに再初期化を設定するには

Transact-SQL の使用

トランザクション パブリケーションに対するプル サブスクリプションを再初期化するには

トランザクション パブリケーションに対するプッシュ サブスクリプションを再初期化するには

マージ パブリケーションに対するプル サブスクリプションを再初期化するには

マージ パブリケーションに対するプッシュ サブスクリプションを再初期化するには

新しいマージ パブリケーションを作成するときに再初期化ポリシーを設定するには

既存のマージ パブリケーションの再初期化ポリシーを変更するには

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

トランザクション パブリケーションに対するプル サブスクリプションを再初期化するには

トランザクション パブリケーションに対するプッシュ サブスクリプションを再初期化するには

マージ パブリケーションに対するプル サブスクリプションを再初期化するには

マージ パブリケーションに対するプッシュ サブスクリプションを再初期化するには

例 (RMO)

関連するコンテンツ

フィードバック

その他のリソース

Management Studio で単一のプッシュサブスクリプションまたはプルサブスクリプションに再初期化を設定するには (パブリッシャーで実行)

Management Studio で単一のプルサブスクリプションに再初期化を設定するには (サブスクライバーで実行)

レプリケーションモニターで単一のプッシュサブスクリプションまたはプルサブスクリプションに再初期化を設定するには

レプリケーションモニターですべてのサブスクリプションに再初期化を設定するには

トランザクションパブリケーションに対するプルサブスクリプションを再初期化するには

トランザクションパブリケーションに対するプッシュサブスクリプションを再初期化するには

マージパブリケーションに対するプルサブスクリプションを再初期化するには

マージパブリケーションに対するプッシュサブスクリプションを再初期化するには

新しいマージパブリケーションを作成するときに再初期化ポリシーを設定するには

既存のマージパブリケーションの再初期化ポリシーを変更するには

トランザクションパブリケーションに対するプルサブスクリプションを再初期化するには

トランザクションパブリケーションに対するプッシュサブスクリプションを再初期化するには

マージパブリケーションに対するプルサブスクリプションを再初期化するには

マージパブリケーションに対するプッシュサブスクリプションを再初期化するには