レプリケートされたデータの検証

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

トランザクション レプリケーションとマージ レプリケーションを使用すると、サブスクライバーのデータがパブリッシャーのデータと一致するかどうかを検証できます。 検証は、1 つのパブリケーションの特定のサブスクリプション、またはすべてのサブスクリプションに対して行うことができます。 次のいずれかの種類の検証を指定すると、ディストリビューション エージェントまたはマージ エージェントは次回の実行時にデータを検証します。

  • 行数のみ。 サブスクライバーのテーブルにパブリッシャーのテーブルと同じ数の行があるかどうかを検証しますが、行の内容が一致するかどうかについては検証しません。 行数の確認は、データに問題があるかどうかを調べる手軽な検証方法です。
  • 行数とバイナリ チェックサム。 パブリッシャーとサブスクライバーの行数に加え、チェックサム アルゴリズムを使用して、すべてのデータのチェックサムが計算されます。 行数の検証で失敗となった場合、チェックサムは実行されません。

サブスクライバーとパブリッシャーのデータが一致するかどうかの検証に加え、マージ レプリケーションでは、各サブスクライバーに対してデータが正しくパーティション分割されているかどうかを検証する機能も用意されています。 詳細については、「Validate Partition Information for a Merge Subscriber」 (マージ サブスクライバーのパーティション情報の検証) を参照してください。

データ検証の動作

SQL Server は、パブリッシャー側の行数やチェックサムを計算し、それらの値をサブスクライバー側で計算された行数やチェックサムと比較することで、データの検証を行います。 パブリケーション テーブル全体に対して 1 つの値が計算され、サブスクリプション テーブル全体に対して 1 つの値が計算されますが、 text、 ntext、または image 列のデータは計算に含まれません。

計算が行われている間は、行数またはチェックサムの計算が行われているテーブルに共有ロックが一時的にかかりますが、計算はすぐに終了し、通常、数秒で共有ロックは解除されます。

バイナリ チェックサムを使用する場合は、32 ビット CRC (冗長性検査) がデータ ページの物理的な行ではなく、列ごとに実行されます。 これにより、テーブルの列がデータ ページで物理的にどのような順序であっても、行については同じ CRC 値が計算されます。 バイナリ チェックサムを使用した検証は、パブリケーション上に行フィルターまたは列フィルターがある場合に使用できます。

データの検証は、3 つの部分で構成されるプロセスです。

  1. パブリケーションの単一のサブスクリプションまたはすべてのサブスクリプションが検証対象として マーク されます。 [サブスクリプションの 検証]、[ サブスクリプションの検証]、[ すべてのサブスクリプションの検証 ] ダイアログ ボックスで、サブスクリプションの検証をマークします。このダイアログ ボックスは、MicrosoftSQL Server Management Studio の [ローカル パブリケーション] フォルダーと [ローカル サブスクリプション] フォルダーから入手できます。 また、 [すべてのサブスクリプション] タブ、 [サブスクリプション ウォッチ リスト] タブ、およびレプリケーション モニターのパブリケーション ノードでもサブスクリプションにマークを付けることができます。 レプリケーション モニターの起動の詳細については、「Start the Replication Monitor」 (レプリケーション モニターの開始) を参照してください。

  2. サブスクリプションは、ディストリビューション エージェント (トランザクション レプリケーションの場合) またはマージ エージェント (マージ レプリケーションの場合) による次回の同期時に検証されます。 ディストリビューション エージェントは、通常は連続して実行されるので、検証はすぐに実行されます。マージ エージェントは、通常は要求時に実行されるので、エージェントを実行した後で検証が実行されます。

  3. 検証結果は次の場所で表示できます。

    • レプリケーション モニターの詳細ウィンドウ : トランザクション レプリケーションの場合は [ディストリビューターからサブスクライバーまでの履歴] タブ、およびマージ レプリケーションの場合は [同期の履歴] タブ
    • Management Studio の [同期の状態の表示] ダイアログ ボックス。

注意点と制約

  • レプリケーション モニターの手順は、プッシュ サブスクリプションにのみ適用されます。プル サブスクリプションはレプリケーション モニターでは同期できないからです。 ただし、レプリケーション モニターで、サブスクリプションに検証対象のマークを付けたり、プル サブスクリプションの検証結果を表示することはできます。
  • 検証結果には、検証が成功したかどうかが示されますが、失敗した場合、検証に失敗した行は示されません。 パブリッシャーとサブスクライバーのデータを比較するには、 tablediff Utilityを使用します。 レプリケートされたデータでのこのユーティリティの使用の詳細については、「レプリケート テーブル間の違いを比較する (レプリケーション プログラミング)」を参照してください。

データの検証に際しては、次の点に注意してください。

  • データを検証する前にサブスクライバー側のすべての更新操作を停止する必要があります (検証実行時にパブリッシャー側の操作を停止する必要はありません)。

  • チェックサムおよびバイナリ チェックサムを使用した検証を大規模なデータセットに対して行う場合には、大量のプロセッサ リソースが必要になるので、レプリケーションで使用するサーバーの利用状況が最小のときに検証を行うようにスケジュールする必要があります。

  • レプリケーションはテーブルのみを検証します。スキーマのみのアーティクル (ストアド プロシージャなど) がパブリッシャーとサブスクライバーで同じであるかどうかは検証しません。

  • バイナリ チェックサムは、パブリッシュされたどのテーブルでも使用できます。 チェックサムでは、列フィルターのあるテーブル、または列のオフセットが異なる論理テーブル構造を検証できません (列を削除または追加する ALTER TABLE ステートメントが原因です)。

  • レプリケーション検証では、 checksum 関数と binary_checksum関数が 使用されます。 各関数の動作については、「CHECKSUM (Transact-SQL)」と「BINARY_CHECKSUM (Transact-SQL)」を参照してください。

  • バイナリ チェックサムまたはチェックサムを使用した検証では、データ型がサブスクライバー側とパブリッシャー側とで異なる場合には、誤ってエラーを報告することがあります。 これは、次のいずれかの操作を行う場合に発生する可能性があります。

    • SQL Server の初期バージョンのデータ型をマップするスキーマ オプションを明示的に設定している場合。
    • マージ パブリケーションに対するパブリケーションの互換性レベルを SQL Server の初期バージョンに設定し、パブリッシュされたテーブルに、このバージョンに対してマップする必要がある 1 つ以上のデータ型が含まれている場合。
    • サブスクリプションを手動で初期化し、サブスクライバで異なるデータ型を使用する。

  • バイナリ チェックサムおよびチェックサムによる検証は、トランザクション レプリケーションの変換可能なサブスクリプションではサポートされていません。

  • SQL Server 以外のサブスクライバーにレプリケートされたデータの検証はサポートされていません。

データ検証の結果

検証が完了すると、ディストリビューション エージェントまたはマージ エージェントは成功または失敗に関するメッセージをログに記録します (レプリケーションでは失敗した行については報告されません)。 これらのメッセージは、SQL Server Management Studio、レプリケーション モニター、およびレプリケーション システム テーブルで表示できます。 操作方法に関する上記のトピックは、検証の実行方法と結果を表示する方法を示しています。

データ検証の問題に対処するために、次の点を検討してください。

  • 失敗が通知されるように、 [レプリケーション: サブスクライバーでデータ検証で問題が見つかりました] というレプリケーション警告を設定します。 詳細については、「定義済みレプリケーション アラートの構成 (SQL Server Management Studio)(administration/configure-predefined-replication-alerts-sql-server-management-studio.md)」を参照してください。

  • 検証の失敗はアプリケーションにとって問題となりますか? 検証の失敗が問題となる場合、データを手動で更新して同期するか、サブスクリプションを再初期化してください。

トランザクション レプリケーションのアーティクル

SQL Server Management Studio の使用

  1. SQL Server Management Studio でパブリッシャーに接続し、サーバー ノードを展開します。

  2. [レプリケーション] フォルダーを展開し、 [ローカル パブリケーション] フォルダーを展開します。

  3. サブスクリプションを検証するパブリケーションを右クリックし、 [サブスクリプションの検証]をクリックします。

  4. [サブスクリプションの検証] ダイアログ ボックスで、次のように検証するサブスクリプションを選択します。

    • [すべての SQL Server サブスクリプションを検証する]を選択する。
    • [以下のサブスクリプションを検証する]を選択し、1 つ以上のサブスクリプションを選択する。

  5. 実行する検証の種類 (行数、または行数とチェックサム) を指定するには、 [検証オプション]をクリックし、 [サブスクリプションの検証オプション] ダイアログ ボックスでオプションを指定します。

  6. OK をクリックします。

  7. レプリケーション モニターまたは [同期の状態の表示] ダイアログ ボックスで検証結果を表示します。 サブスクリプションごとに、次の手順を実行します。

    1. パブリケーションを展開し、サブスクリプションを右クリックして、 [同期の状態の表示]をクリックします。
    2. エージェントが実行されていない場合は、 [同期の状態の表示] ダイアログ ボックスの [開始] をクリックします。 ダイアログ ボックスには、検証に関する情報メッセージが表示されます。

    検証に関するメッセージが表示されない場合、エージェントは既にその後のメッセージを記録しています。 この場合は、検証結果をレプリケーション モニターに表示します。 詳細については、このトピックのレプリケーション モニターの実行手順を参照してください。

Transact-SQL の使用 (T-SQL)

すべてのアーティクル

  1. パブリッシャー側のパブリケーション データベースに対して、sp_publication_validation (Transact-SQL) を実行します。 @rowcount_onlyに@publicationと次のいずれかの値を指定します。

    • 1 - 行数チェックのみ (既定値)
    • 2 - 行数とバイナリ チェックサム

    Note

    sp_publication_validation (Transact-SQL) を実行する場合、sp_article_validation (Transact-SQL) がパブリケーション内の各アーティクルに対して実行されます。 sp_publication_validation (Transact-SQL) を正常に実行するためには、パブリッシュされたベース テーブルのすべての列に対して SELECT 権限が必要です。

  2. (省略可) ディストリビューション エージェントがまだ実行されていない場合は、各サブスクリプションについてディストリビューション エージェントを開始します。 詳細については、「 Synchronize a Pull Subscription 」および「 Synchronize a Push Subscription」を参照してください。

  3. エージェントの出力で検証結果を確認します。 詳細については、「レプリケートされたデータの検証」 を参照してください。

単一のアーティクル

  1. パブリッシャー側のパブリケーション データベースに対して、sp_article_validation (Transact-SQL) を実行します。 @publication、@articleのアーティクルの名前、および@rowcount_onlyに次のいずれかの値を指定します。

    • 1 - 行数チェックのみ (既定値)
    • 2 - 行数とバイナリ チェックサム

    Note

    sp_article_validation (Transact-SQL) を正常に実行するためには、パブリッシュされたベース テーブルのすべての列に対して SELECT 権限が必要です。

  2. (省略可) ディストリビューション エージェントがまだ実行されていない場合は、各サブスクリプションについてディストリビューション エージェントを開始します。 詳細については、「 Synchronize a Pull Subscription 」および「 Synchronize a Push Subscription」を参照してください。

  3. エージェントの出力で検証結果を確認します。 詳細については、「レプリケートされたデータの検証」 を参照してください。

単一のサブスクライバー

  1. パブリッシャー側のパブリケーション データベースで、BEGIN TRANSACTION (Transact-SQL) を使用して明示的なトランザクションを開始します。

  2. パブリッシャー側のパブリケーション データベースに対して、sp_marksubscriptionvalidation (Transact-SQL) を実行します。 @publicationのパブリケーション、@subscriberのサブスクライバーの名前、および@destination_dbのサブスクリプション データベースの名前を指定します。

  3. (省略可) 検証の対象となる各サブスクリプションについて、手順 2. を繰り返します。

  4. パブリッシャー側のパブリケーション データベースに対して、sp_article_validation (Transact-SQL) を実行します。 @publication、@articleのアーティクルの名前、および@rowcount_onlyに次のいずれかの値を指定します。

    • 1 - 行数チェックのみ (既定値)
    • 2 - 行数とバイナリ チェックサム

    Note

    sp_article_validation (Transact-SQL) を正常に実行するためには、パブリッシュされたベース テーブルのすべての列に対して SELECT 権限が必要です。

  5. パブリッシャー側のパブリケーション データベースに対して、COMMIT TRANSACTION (Transact-SQL) を使用してトランザクションをコミットします。

  6. (省略可) 検証の対象となる各アーティクルについて、手順 1. から手順 5. を繰り返します。

  7. (省略可) ディストリビューション エージェントがまだ実行されていない場合は、開始します。 詳細については、「 Synchronize a Pull Subscription 」および「 Synchronize a Push Subscription」を参照してください。

  8. エージェントの出力で検証結果を確認します。 詳しくは、「サブスクライバーでデータを検証する」をご覧ください。

トランザクション パブリケーションへのすべてのプッシュ サブスクリプション

レプリケーション モニターを使用する

  1. レプリケーション モニターの左ペインでパブリッシャー グループを展開し、パブリッシャーを展開します。
  2. サブスクリプションを検証するパブリケーションを右クリックし、 [サブスクリプションの検証]をクリックします。
  3. [サブスクリプションの検証] ダイアログ ボックスで、次のように検証するサブスクリプションを選択します。
    • [すべての SQL Server サブスクリプションを検証する]を選択する。
    • [以下のサブスクリプションを検証する]を選択し、1 つ以上のサブスクリプションを選択する。
  4. 実行する検証の種類 (行数、または行数とチェックサム) を指定するには、 [検証オプション]をクリックし、 [サブスクリプションの検証オプション] ダイアログ ボックスでオプションを指定します。
  5. OK をクリックします。
  6. [すべてのサブスクリプション] タブをクリックします。
  7. 検証結果を表示します。 プッシュ サブスクリプションごとに、次の手順を実行します。
    1. エージェントが実行されていない場合、サブスクリプションを右クリックし、 [同期の開始]をクリックします。
    2. サブスクリプションを右クリックし、 [詳細表示]をクリックします。
    3. [ディストリビューターからサブスクライバーまでの履歴] タブの [選択されたセッションのアクション] テキスト領域に情報が表示されます。

Merge Publication の 1 つのサブスクリプションに対して

SQL Server Management Studio の使用

  1. SQL Server Management Studio でパブリッシャーに接続し、サーバー ノードを展開します。

  2. [レプリケーション] フォルダーを展開し、 [ローカル パブリケーション] フォルダーを展開します。

  3. サブスクリプションを検証するパブリケーションを展開し、サブスクリプションを右クリックして、 [サブスクリプションの検証]をクリックします。

  4. [サブスクリプションの検証] ダイアログ ボックスで、 [このサブスクリプションを検証する]を選択します。

  5. 実行する検証の種類 (行数、または行数とチェックサム) を指定するには、 [オプション]をクリックし、 [サブスクリプションの検証オプション] ダイアログ ボックスでオプションを指定します。

  6. OK をクリックします。

  7. レプリケーション モニターまたは [同期の状態の表示] ダイアログ ボックスで検証結果を表示します。

    1. パブリケーションを展開し、サブスクリプションを右クリックして、 [同期の状態の表示]をクリックします。
    2. エージェントが実行されていない場合は、 [同期の状態の表示] ダイアログ ボックスの [開始] をクリックします。 ダイアログ ボックスには、検証に関する情報メッセージが表示されます。

    検証に関するメッセージが表示されない場合、エージェントは既にその後のメッセージを記録しています。 この場合は、検証結果をレプリケーション モニターに表示します。 詳細については、このトピックのレプリケーション モニターの実行手順を参照してください。

Transact-SQL の使用 (T-SQL)

  1. パブリッシャー側のパブリケーション データベースに対して、sp_validatemergesubscription (Transact-SQL) を実行します。 @publication、@subscriberのサブスクライバーの名前、@subscriber_dbのサブスクリプション データベースの名前、および@levelに次のいずれかの値を指定します。

    • 1 - 行数の検証のみ
    • 3 - 行数とバイナリチェックサムの検証

    これにより、選択されたサブスクリプションが検証対象としてマークされます。

  2. 各サブスクリプションのマージ エージェントを開始します。 詳細については、「 Synchronize a Pull Subscription 」および「 Synchronize a Push Subscription」を参照してください。

  3. エージェントの出力で検証結果を確認します。

  4. 検証の対象となる各サブスクリプションについて、手順 1. から手順 3. を繰り返します。

Note

Replication マージ エージェント を実行するときに、 -Validateパラメーターを指定することによって、マージ パブリケーションのサブスクリプションについても同期処理の最後に検証を実行できます。

マージ パブリケーションのすべてのサブスクリプション

SQL Server Management Studio の使用

  1. SQL Server Management Studio でパブリッシャーに接続し、サーバー ノードを展開します。

  2. [レプリケーション] フォルダーを展開し、 [ローカル パブリケーション] フォルダーを展開します。

  3. サブスクリプションを検証するパブリケーションを右クリックし、 [すべてのサブスクリプションの検証]をクリックします。

  4. [すべてのサブスクリプションの検証] ダイアログ ボックスで、実行する検証の種類 (行数、または行数とチェックサム) を指定します。

  5. OK をクリックします。

  6. レプリケーション モニターまたは [同期の状態の表示] ダイアログ ボックスで検証結果を表示します。 サブスクリプションごとに、次の手順を実行します。

    1. パブリケーションを展開し、サブスクリプションを右クリックして、 [同期の状態の表示]をクリックします。
    2. エージェントが実行されていない場合は、 [同期の状態の表示] ダイアログ ボックスの [開始] をクリックします。 ダイアログ ボックスには、検証に関する情報メッセージが表示されます。

    検証に関するメッセージが表示されない場合、エージェントは既にその後のメッセージを記録しています。 この場合は、検証結果をレプリケーション モニターに表示します。 詳細については、このトピックのレプリケーション モニターの実行手順を参照してください。

Transact-SQL の使用 (T-SQL)

  1. パブリッシャー側のパブリケーション データベースに対して、sp_validatemergepublication (Transact-SQL) を実行します。 @levelに@publicationと次のいずれかの値を指定します。

    • 1 - 行数の検証のみ
    • 3 - 行数とバイナリチェックサムの検証

    これにより、すべてのサブスクリプションが検証対象としてマークされます。

  2. 各サブスクリプションのマージ エージェントを開始します。 詳細については、「 Synchronize a Pull Subscription 」および「 Synchronize a Push Subscription」を参照してください。

  3. エージェントの出力で検証結果を確認します。 詳しくは、「サブスクライバーでデータを検証する」をご覧ください。

マージ パブリケーションに対する単一のプッシュ サブスクリプション

レプリケーション モニターを使用する

  1. レプリケーション モニターで、左ペインのパブリッシャー グループを展開し、パブリッシャーを展開してパブリケーションをクリックします。
  2. [すべてのサブスクリプション] タブをクリックします。
  3. 検証するサブスクリプションを右クリックし、 [サブスクリプションの検証]をクリックします。
  4. [サブスクリプションの検証] ダイアログ ボックスで、 [このサブスクリプションを検証する]を選択します。
  5. 実行する検証の種類 (行数、または行数とチェックサム) を指定するには、 [オプション]をクリックし、 [サブスクリプションの検証オプション] ダイアログ ボックスでオプションを指定します。
  6. OK をクリックします。
  7. [すべてのサブスクリプション] タブをクリックします。
  8. 検証結果は、次の場所で表示できます。
    1. エージェントが実行されていない場合、サブスクリプションを右クリックし、 [同期の開始]をクリックします。
    2. サブスクリプションを右クリックし、 [詳細表示]をクリックします。
    3. [同期の履歴] タブの [選択されたセッションの最終メッセージ] テキスト領域に情報が表示されます。

マージ パブリケーションのすべてのプッシュ サブスクリプション

レプリケーション モニターを使用する

  1. レプリケーション モニターの左ペインでパブリッシャー グループを展開し、パブリッシャーを展開します。
  2. サブスクリプションを検証するパブリケーションを右クリックし、 [すべてのサブスクリプションの検証]をクリックします。
  3. [すべてのサブスクリプションの検証] ダイアログ ボックスで、実行する検証の種類 (行数、または行数とチェックサム) を指定します。
  4. OK をクリックします。
  5. [すべてのサブスクリプション] タブをクリックします。
  6. 検証結果を表示します。 プッシュ サブスクリプションごとに、次の手順を実行します。
    1. エージェントが実行されていない場合、サブスクリプションを右クリックし、 [同期の開始]をクリックします。
    2. サブスクリプションを右クリックし、 [詳細表示]をクリックします。
    3. [同期の履歴] タブの [選択されたセッションの最終メッセージ] テキスト領域に情報が表示されます。

マージ エージェント パラメーターを使用してデータを検証する

  1. サブスクライバー (プル サブスクリプションの場合) またはディストリビューター (プッシュ サブスクリプションの場合) で、次のいずれかの方法でコマンド プロンプトからマージ エージェントを開始します。

    • -Validate パラメーターの値に、 1 (行数) または 3 (行数とバイナリ チェックサム) を指定します。
    • -ProfileName パラメーターに、 rowcount validation または rowcount and checksum validation を指定します。

    詳細については、「 Synchronize a Pull Subscription 」または「 Synchronize a Push Subscription」を参照してください。

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

レプリケーションでは、サブスクライバーのデータがパブリッシャーのデータと一致するかどうかを、レプリケーション管理オブジェクト (RMO) を使用してプログラムから検証できます。 使用するオブジェクトは、レプリケーション トポロジの種類によって異なります。 トランザクション レプリケーションでは、パブリケーションのサブスクリプションをすべて検証する必要があります。

Note

例については、このセクションの後半の「 例 (RMO)」を参照してください。

トランザクション パブリケーションのすべてのアーティクルについてデータを検証するには

  1. ServerConnection クラスを使用して、パブリッシャーへの接続を作成します。

  2. TransPublication クラスのインスタンスを作成します。 パブリケーションの Name プロパティおよび DatabaseName プロパティを設定します。 ConnectionContext プロパティに、手順 1. の接続を設定します。

  3. LoadProperties メソッドを呼び出して、オブジェクトの残りのプロパティを取得します。 このメソッドが falseを返す場合、手順 2 のパブリケーション プロパティが正しく定義されていないか、パブリケーションが存在しません。

  4. ValidatePublication メソッドを呼び出します。 次のパラメーターを指定します。

    • ValidationOption
    • ValidationMethod
    • 検証が終了した後、ディストリビューション エージェントを停止するかどうかを示すブール値

    これにより、アーティクルが検証対象としてマークされます。

  5. まだディストリビューション エージェントを実行していない場合は、ディストリビューション エージェントを起動して、各サブスクリプションを同期します。 詳細については、「 Synchronize a Push Subscription 」または「 Synchronize a Pull Subscription」を参照してください。 検証操作の結果は、エージェントの履歴に出力されます。 詳しくは、「 Monitoring Replication」をご覧ください。

マージ パブリケーションのすべてのサブスクリプションについてデータを検証するには

  1. ServerConnection クラスを使用して、パブリッシャーへの接続を作成します。
  2. MergePublication クラスのインスタンスを作成します。 パブリケーションの Name プロパティおよび DatabaseName プロパティを設定します。 ConnectionContext プロパティに、手順 1. の接続を設定します。
  3. LoadProperties メソッドを呼び出して、オブジェクトの残りのプロパティを取得します。 このメソッドが falseを返す場合、手順 2 のパブリケーション プロパティが正しく定義されていないか、パブリケーションが存在しません。
  4. ValidatePublication メソッドを呼び出します。 必要な ValidationOptionを指定します。
  5. 各サブスクリプションについてマージ エージェントを実行して検証を開始するか、次回予定されているエージェントの実行を待ちます。 詳細については、「 Synchronize a Pull Subscription 」および「 Synchronize a Push Subscription」を参照してください。 検証操作の結果は、エージェントの履歴に出力されます。この履歴は、レプリケーション モニターを使って表示できます。 詳しくは、「 Monitoring Replication」をご覧ください。

マージ パブリケーションの 1 つのサブスクリプション内のデータを検証するには

  1. ServerConnection クラスを使用して、パブリッシャーへの接続を作成します。
  2. MergePublication クラスのインスタンスを作成します。 パブリケーションの Name プロパティおよび DatabaseName プロパティを設定します。 ConnectionContext プロパティに、手順 1. の接続を設定します。
  3. LoadProperties メソッドを呼び出して、オブジェクトの残りのプロパティを取得します。 このメソッドが falseを返す場合、手順 2 のパブリケーション プロパティが正しく定義されていないか、パブリケーションが存在しません。
  4. ValidateSubscription メソッドを呼び出します。 サブスクライバーの名前、検証対象のサブスクリプション データベース、および、必要な ValidationOptionを指定します。
  5. 目的のサブスクリプションについてマージ エージェントを実行して検証を開始するか、次回予定されているエージェントの実行を待ちます。 詳細については、「 Synchronize a Pull Subscription 」および「 Synchronize a Push Subscription」を参照してください。 検証操作の結果は、エージェントの履歴に出力されます。この履歴は、レプリケーション モニターを使って表示できます。 詳しくは、「 Monitoring Replication」をご覧ください。

例 (RMO)

次の例では、トランザクション パブリケーションのすべてのサブスクリプションを、行数検証の対象としてマークします。

// Define the server, database, and publication names
string publisherName = publisherInstance;
string publicationName = "AdvWorksProductTran";
string publicationDbName = "AdventureWorks2012";

TransPublication publication;

// Create a connection to the Publisher.
ServerConnection conn = new ServerConnection(publisherName);

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

    // Set the required properties for the publication.
    publication = new TransPublication();
    publication.ConnectionContext = conn;
    publication.Name = publicationName;
    publication.DatabaseName = publicationDbName;

    // If we can't get the properties for this publication, 
    // throw an application exception.
    if (publication.LoadProperties())
    {
        // Initiate validataion for all subscriptions to this publication.
        publication.ValidatePublication(ValidationOption.RowCountOnly,
            ValidationMethod.ConditionalFast, false);

        // If not already running, start the Distribution Agent at each 
        // Subscriber to synchronize and validate the subscriptions.
    }
    else
    {
        throw new ApplicationException(String.Format(
            "Settings could not be retrieved for the publication. " +
            "Ensure that the publication {0} exists on {1}.",
            publicationName, publisherName));
    }
}
catch (Exception ex)
{
    // Do error handling here.
    throw new ApplicationException(
        "Subscription validation could not be initiated.", ex);
}
finally
{
    conn.Disconnect();
}

' Define the server, database, and publication names
Dim publisherName As String = publisherInstance
Dim publicationName As String = "AdvWorksProductTran"
Dim publicationDbName As String = "AdventureWorks2012"

Dim publication As TransPublication

' Create a connection to the Publisher.
Dim conn As ServerConnection = New ServerConnection(publisherName)

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

    ' Set the required properties for the publication.
    publication = New TransPublication()
    publication.ConnectionContext = conn
    publication.Name = publicationName
    publication.DatabaseName = publicationDbName

    ' If we can't get the properties for this publication, 
    ' throw an application exception.
    If publication.LoadProperties() Then

        ' Initiate validataion for all subscriptions to this publication.
        publication.ValidatePublication(ValidationOption.RowCountOnly, _
         ValidationMethod.ConditionalFast, False)

        ' If not already running, start the Distribution Agent at each 
        ' Subscriber to synchronize and validate the subscriptions.
    Else
        Throw New ApplicationException(String.Format( _
         "Settings could not be retrieved for the publication. " + _
         "Ensure that the publication {0} exists on {1}.", _
         publicationName, publisherName))
    End If
Catch ex As Exception
    ' Do error handling here.
    Throw New ApplicationException( _
     "Subscription validation could not be initiated.", ex)
Finally
    conn.Disconnect()
End Try

次の例では、マージ パブリケーションの特定のサブスクリプションを、行数検証の対象としてマークします。

// Define the server, database, and publication names
string publisherName = publisherInstance;
string publicationName = "AdvWorksSalesOrdersMerge";
string publicationDbName = "AdventureWorks2012";
string subscriberName = subscriberInstance;
string subscriptionDbName = "AdventureWorks2012Replica";

MergePublication publication;

// Create a connection to the Publisher.
ServerConnection conn = new ServerConnection(publisherName);

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

    // Set the required properties for the publication.
    publication = new MergePublication();
    publication.ConnectionContext = conn;
    publication.Name = publicationName;
    publication.DatabaseName = publicationDbName;


    // If we can't get the properties for this merge publication, then throw an application exception.
    if (publication.LoadProperties())
    {
        // Initiate validation of the specified subscription.
        publication.ValidateSubscription(subscriberName,
            subscriptionDbName, ValidationOption.RowCountOnly);
        
        // Start the Merge Agent to synchronize and validate the subscription.
    }
    else
    {
        throw new ApplicationException(String.Format(
            "Settings could not be retrieved for the publication. " +
            "Ensure that the publication {0} exists on {1}.",
            publicationName, publisherName));
    }
}
catch (Exception ex)
{
    // Do error handling here.
    throw new ApplicationException(String.Format(
        "The subscription at {0} to the {1} publication could not " +
        "be validated.", subscriberName, publicationName), ex);
}
finally
{
    conn.Disconnect();
}

' Define the server, database, and publication names
Dim publisherName As String = publisherInstance
Dim publicationName As String = "AdvWorksSalesOrdersMerge"
Dim publicationDbName As String = "AdventureWorks2012"
Dim subscriberName As String = subscriberInstance
Dim subscriptionDbName As String = "AdventureWorks2012Replica"

Dim publication As MergePublication

' Create a connection to the Publisher.
Dim conn As ServerConnection = New ServerConnection(publisherName)

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

    ' Set the required properties for the publication.
    publication = New MergePublication()
    publication.ConnectionContext = conn
    publication.Name = publicationName
    publication.DatabaseName = publicationDbName

    ' If we can't get the properties for this merge publication, then throw an application exception.
    If publication.LoadProperties() Then
        ' Initiate validation of the specified subscription.
        publication.ValidateSubscription(subscriberName, _
         subscriptionDbName, ValidationOption.RowCountOnly)

        ' Start the Merge Agent to synchronize and validate the subscription.
    Else
        Throw New ApplicationException(String.Format( _
         "Settings could not be retrieved for the publication. " + _
         "Ensure that the publication {0} exists on {1}.", _
         publicationName, publisherName))
    End If
Catch ex As Exception
    ' Do error handling here.
    Throw New ApplicationException(String.Format( _
     "The subscription at {0} to the {1} publication could not " + _
     "be validated.", subscriberName, publicationName), ex)
Finally
    conn.Disconnect()
End Try
  • Last updated on