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

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

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

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

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

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

Note

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

データ検証の動作

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

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

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

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

パブリケーションの単一のサブスクリプションまたはすべてのサブスクリプションが検証対象として マーク されます。 Microsoft SQL Server Management Studio の [ローカルパブリケーション] フォルダーと [ローカルサブスクリプション] フォルダーから使用できる、[サブスクリプションの検証]、[サブスクリプションの検証] および [すべてのサブスクリプションの検証] の各ダイアログボックスで検証対象のサブスクリプションにマークを付けます。また、 [すべてのサブスクリプション] タブ、 [サブスクリプションウォッチリスト] タブ、およびレプリケーションモニターのパブリケーションノードでもサブスクリプションにマークを付けることができます。レプリケーションモニターの起動の詳細については、「Start the Replication Monitor」 (レプリケーションモニターの開始) を参照してください。
サブスクリプションは、ディストリビューションエージェント (トランザクションレプリケーションの場合) またはマージエージェント (マージレプリケーションの場合) による次回の同期時に検証されます。ディストリビューションエージェントは、通常は連続して実行されるので、検証はすぐに実行されます。マージエージェントは、通常は要求時に実行されるので、エージェントを実行した後で検証が実行されます。
検証結果は次の場所で表示できます。
- レプリケーションモニターの詳細ウィンドウ : トランザクションレプリケーションの場合は [ディストリビューターからサブスクライバーまでの履歴] タブ、およびマージレプリケーションの場合は [同期の履歴] タブ
- Management Studio の [同期の状態の表示] ダイアログボックス。

注意点と制約

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

データを検証する前にサブスクライバー側のすべての更新操作を停止する必要があります (検証実行時にパブリッシャー側の操作を停止する必要はありません)。
チェックサムおよびバイナリチェックサムを使用した検証を大規模なデータセットに対して行う場合には、大量のプロセッサリソースが必要になるので、レプリケーションで使用するサーバーの利用状況が最小のときに検証を行うようにスケジュールする必要があります。
レプリケーションはテーブルのみを検証します。スキーマのみのアーティクル (ストアドプロシージャなど) がパブリッシャーとサブスクライバーで同じであるかどうかは検証しません。
バイナリチェックサムは、パブリッシュされたどのテーブルでも使用できます。チェックサムは、列フィルターの設定されたテーブル、または列オフセットが異なる論理テーブル構造 (列を削除または追加する ALTER TABLE ステートメントの結果) は検証できません。
レプリケーション検証には、 checksum 関数および binary_checksum 関数を使用します。各関数の動作については、「CHECKSUM (Transact-SQL)」と「BINARY_CHECKSUM (Transact-SQL)」を参照してください。
バイナリチェックサムまたはチェックサムを使用した検証では、データ型がサブスクライバー側とパブリッシャー側とで異なる場合には、誤ってエラーを報告することがあります。これは、次のいずれかの場合に発生する可能性があります。
- SQL Server の初期バージョンのデータ型をマップするスキーマオプションを明示的に設定している場合。
- マージパブリケーションに対するパブリケーションの互換性レベルを SQL Server の初期バージョンに設定し、パブリッシュされたテーブルに、このバージョンに対してマップする必要がある 1 つ以上のデータ型が含まれている場合。
- サブスクリプションを手動で初期化し、サブスクライバーで異なるデータ型を使用している場合。
バイナリチェックサムおよびチェックサムによる検証は、トランザクションレプリケーションの変換可能なサブスクリプションではサポートされていません。
SQL Server 以外のサブスクライバーにレプリケートされたデータの検証はサポートされていません。
レプリケーションモニターの手順は、プッシュサブスクリプションにのみ適用されます。プルサブスクリプションはレプリケーションモニターでは同期できないからです。ただし、レプリケーションモニターで、サブスクリプションに検証対象のマークを付けたり、プルサブスクリプションの検証結果を表示することはできます。
検証結果には、検証が成功したかどうかが示されますが、失敗した場合、検証に失敗した行は示されません。パブリッシャーとサブスクライバーのデータを比較するには、 tablediff Utilityを使用します。レプリケートされたデータでのこのユーティリティの使用の詳細については、「レプリケートテーブル間の違いを比較する (レプリケーションプログラミング)」を参照してください。

データ検証の結果

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

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

失敗が通知されるように、 [レプリケーション: サブスクライバーでデータ検証で問題が見つかりました] というレプリケーション警告を設定します。詳細については、「定義済みのレプリケーションの警告の構成 (SQL Server Management Studio)」を参照してください。
検証の失敗はアプリケーションにとって問題となりますか? 検証の失敗が問題となる場合、データを手動で更新して同期するか、サブスクリプションを再初期化してください。
- データを更新するには tablediff ユーティリティを使用します。このユーティリティの使用方法の詳細については、「レプリケートテーブル間の違いを比較する (レプリケーションプログラミング) 」を参照してください。
- 再初期化の詳細については、「Reinitialize Subscriptions」 (サブスクリプションの再初期化) を参照してください。

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

SQL Server Management Studio を使用する

SQL Server Management Studio でパブリッシャーに接続し、サーバーノードを展開します。
[レプリケーション] フォルダーを展開し、 [ローカルパブリケーション] フォルダーを展開します。
サブスクリプションを検証するパブリケーションを右クリックし、 [サブスクリプションの検証]をクリックします。
[サブスクリプションの検証] ダイアログボックスで、次のように検証するサブスクリプションを選択します。
- [すべての SQL Server サブスクリプションを検証する]を選択する。
- [以下のサブスクリプションを検証する]を選択し、1 つ以上のサブスクリプションを選択する。
実行する検証の種類 (行数、または行数とチェックサム) を指定するには、 [検証オプション]をクリックし、 [サブスクリプションの検証オプション] ダイアログボックスでオプションを指定します。
[OK] を選択します。
レプリケーションモニターまたは [同期の状態の表示] ダイアログボックスで検証結果を表示します。サブスクリプションごとに、次の手順を実行します。
1. パブリケーションを展開し、サブスクリプションを右クリックして、 [同期の状態の表示]をクリックします。
2. エージェントが実行されていない場合は、 [同期の状態の表示] ダイアログボックスの [開始] をクリックします。ダイアログボックスには、検証に関する情報メッセージが表示されます。
  検証に関するメッセージが表示されない場合、エージェントは既にその後のメッセージを記録しています。この場合は、検証結果をレプリケーションモニターに表示します。詳細については、このトピックのレプリケーションモニターの実行手順を参照してください。

Transact-SQL の使用

すべてのアーティクル

パブリッシャー側のパブリケーションデータベースに対して、sp_publication_validation (Transact-SQL) を実行します。 @publication を指定し、@rowcount_only には次のいずれかの値を指定します。
- 1 - 行数チェックのみ (既定値)
- 2 - 行数とバイナリチェックサム
Note

sp_publication_validation (Transact-SQL) を実行する場合、sp_article_validation (Transact-SQL) がパブリケーション内の各アーティクルに対して実行されます。 sp_publication_validation (Transact-SQL) を正常に実行するためには、パブリッシュされたベーステーブルのすべての列に対して SELECT 権限が必要です。
(省略可) ディストリビューションエージェントがまだ実行されていない場合は、各サブスクリプションについてディストリビューションエージェントを開始します。詳細については、「 Synchronize a Pull Subscription 」および「 Synchronize a Push Subscription」を参照してください。
エージェントの出力で検証結果を確認します。

単一のアーティクル

パブリッシャー側のパブリケーションデータベースに対して、sp_article_validation (Transact-SQL) を実行します。 @publication を指定し、@article にはアーティクルの名前、@rowcount_only には次のいずれかの値を指定します。
- 1 - 行数チェックのみ (既定値)
- 2 - 行数とバイナリチェックサム
Note

sp_article_validation (Transact-SQL) を正常に実行するためには、パブリッシュされたベーステーブルのすべての列に対して SELECT 権限が必要です。
(省略可) ディストリビューションエージェントがまだ実行されていない場合は、各サブスクリプションについてディストリビューションエージェントを開始します。詳細については、「 Synchronize a Pull Subscription 」および「 Synchronize a Push Subscription」を参照してください。
エージェントの出力で検証結果を確認します。

単一のサブスクライバー

パブリッシャー側のパブリケーションデータベースで、BEGIN TRANSACTION (Transact-SQL) を使用して明示的なトランザクションを開始します。
パブリッシャー側のパブリケーションデータベースに対して、sp_marksubscriptionvalidation (Transact-SQL) を実行します。 @publication にはパブリケーション、@subscriber にはサブスクライバーの名前、@destination_db にはサブスクリプションデータベースの名前を指定します。
(省略可) 検証の対象となる各サブスクリプションについて、手順 2. を繰り返します。
パブリッシャー側のパブリケーションデータベースに対して、sp_article_validation (Transact-SQL) を実行します。 @publication を指定し、@article にはアーティクルの名前、@rowcount_only には次のいずれかの値を指定します。
- 1 - 行数チェックのみ (既定値)
- 2 - 行数とバイナリチェックサム
Note

sp_article_validation (Transact-SQL) を正常に実行するためには、パブリッシュされたベーステーブルのすべての列に対して SELECT 権限が必要です。
パブリッシャー側のパブリケーションデータベースに対して、COMMIT TRANSACTION (Transact-SQL) を使用してトランザクションをコミットします。
(省略可) 検証の対象となる各アーティクルについて、手順 1. から手順 5. を繰り返します。
(省略可) ディストリビューションエージェントがまだ実行されていない場合は、開始します。詳細については、「 Synchronize a Pull Subscription 」および「 Synchronize a Push Subscription」を参照してください。
エージェントの出力で検証結果を確認します。詳しくは、「 Validate Data at the Subscriber」をご覧ください。

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

レプリケーションモニターの使用

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

マージパブリケーションの単一のサブスクリプション

SQL Server Management Studio を使用する

SQL Server Management Studio でパブリッシャーに接続し、サーバーノードを展開します。
[レプリケーション] フォルダーを展開し、 [ローカルパブリケーション] フォルダーを展開します。
サブスクリプションを検証するパブリケーションを展開し、サブスクリプションを右クリックして、 [サブスクリプションの検証]をクリックします。
[サブスクリプションの検証] ダイアログボックスで、 [このサブスクリプションを検証する]を選択します。
実行する検証の種類 (行数、または行数とチェックサム) を指定するには、 [オプション]をクリックし、 [サブスクリプションの検証オプション] ダイアログボックスでオプションを指定します。
[OK] を選択します。
レプリケーションモニターまたは [同期の状態の表示] ダイアログボックスで検証結果を表示します。
1. パブリケーションを展開し、サブスクリプションを右クリックして、 [同期の状態の表示]をクリックします。
2. エージェントが実行されていない場合は、 [同期の状態の表示] ダイアログボックスの [開始] をクリックします。ダイアログボックスには、検証に関する情報メッセージが表示されます。
検証に関するメッセージが表示されない場合、エージェントは既にその後のメッセージを記録しています。この場合は、検証結果をレプリケーションモニターに表示します。詳細については、このトピックのレプリケーションモニターの実行手順を参照してください。

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

SQL Server Management Studio を使用する

SQL Server Management Studio でパブリッシャーに接続し、サーバーノードを展開します。
[レプリケーション] フォルダーを展開し、 [ローカルパブリケーション] フォルダーを展開します。
サブスクリプションを検証するパブリケーションを右クリックし、 [すべてのサブスクリプションの検証]をクリックします。
[すべてのサブスクリプションの検証] ダイアログボックスで、実行する検証の種類 (行数、または行数とチェックサム) を指定します。
[OK] を選択します。
レプリケーションモニターまたは [同期の状態の表示] ダイアログボックスで検証結果を表示します。サブスクリプションごとに、次の手順を実行します。
1. パブリケーションを展開し、サブスクリプションを右クリックして、 [同期の状態の表示]をクリックします。
2. エージェントが実行されていない場合は、 [同期の状態の表示] ダイアログボックスの [開始] をクリックします。ダイアログボックスには、検証に関する情報メッセージが表示されます。
検証に関するメッセージが表示されない場合、エージェントは既にその後のメッセージを記録しています。この場合は、検証結果をレプリケーションモニターに表示します。詳細については、このトピックのレプリケーションモニターの実行手順を参照してください。

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

レプリケーションモニターの使用

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

Transact-SQL の使用

パブリッシャー側のパブリケーションデータベースに対して、sp_validatemergesubscription (Transact-SQL) を実行します。 @publication を指定し、@subscriber にはサブスクライバーの名前、@subscriber_db にはサブスクリプションデータベースの名前、@level には次のいずれかの値を指定します。
- 1 - 行数の検証のみ
- 3 - 行数とバイナリチェックサムの検証
これにより、選択されたサブスクリプションが検証対象としてマークされます。
各サブスクリプションのマージエージェントを開始します。詳細については、「 Synchronize a Pull Subscription 」および「 Synchronize a Push Subscription」を参照してください。
エージェントの出力で検証結果を確認します。
検証の対象となる各サブスクリプションについて、手順 1. から手順 3. を繰り返します。

Note

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

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

レプリケーションモニターの使用

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

Transact-SQL の使用

パブリッシャー側のパブリケーションデータベースに対して、sp_validatemergepublication (Transact-SQL) を実行します。 @publication を指定し、@level には次のいずれかの値を指定します。
- 1 - 行数の検証のみ
- 3 - 行数とバイナリチェックサムの検証
これにより、すべてのサブスクリプションが検証対象としてマークされます。
各サブスクリプションのマージエージェントを開始します。詳細については、「 Synchronize a Pull Subscription 」および「 Synchronize a Push Subscription」を参照してください。
エージェントの出力で検証結果を確認します。詳しくは、「 Validate Data at the Subscriber」をご覧ください。

マージエージェントのパラメーターを使用したデータの検証

サブスクライバー (プルサブスクリプションの場合) またはディストリビューター (プッシュサブスクリプションの場合) で、次のいずれかの方法でコマンドプロンプトからマージエージェントを開始します。
- -Validate パラメーターの値に、 1 (行数) または 3 (行数とバイナリチェックサム) を指定します。
- -ProfileName パラメーターに、 rowcount validation または rowcount and checksum validation を指定します。
詳細については、「 Synchronize a Pull Subscription 」または「 Synchronize a Push Subscription」を参照してください。

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

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

Note

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

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

ServerConnection クラスを使用して、パブリッシャーへの接続を作成します。
TransPublication クラスのインスタンスを作成します。パブリケーションの Name プロパティおよび DatabaseName プロパティを設定します。 ConnectionContext プロパティに、手順 1. の接続を設定します。
LoadProperties メソッドを呼び出して、オブジェクトの残りのプロパティを取得します。このメソッドが falseを返す場合、手順 2. でパブリケーションプロパティを不適切に設定したか、パブリケーションが存在していません。
ValidatePublication メソッドを呼び出します。次のパラメーターを指定します。
- ValidationOption
- ValidationMethod
- 検証が終了した後、ディストリビューションエージェントを停止するかどうかを示すブール値
これにより、アーティクルが検証対象としてマークされます。
まだディストリビューションエージェントを実行していない場合は、ディストリビューションエージェントを起動して、各サブスクリプションを同期します。詳細については、「 Synchronize a Push Subscription 」または「 Synchronize a Pull Subscription」を参照してください。検証操作の結果は、エージェントの履歴に出力されます。詳しくは、「 Monitoring Replication」をご覧ください。

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

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

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

ServerConnection クラスを使用して、パブリッシャーへの接続を作成します。
MergePublication クラスのインスタンスを作成します。パブリケーションの Name プロパティおよび DatabaseName プロパティを設定します。 ConnectionContext プロパティに、手順 1. の接続を設定します。
LoadProperties メソッドを呼び出して、オブジェクトの残りのプロパティを取得します。このメソッドが falseを返す場合、手順 2. でパブリケーションプロパティを不適切に設定したか、パブリケーションが存在していません。
ValidateSubscription メソッドを呼び出します。サブスクライバーの名前、検証対象のサブスクリプションデータベース、および、必要な ValidationOptionを指定します。
目的のサブスクリプションについてマージエージェントを実行して検証を開始するか、次回予定されているエージェントの実行を待ちます。詳細については、「 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 = "AdventureWorks2022";

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 = "AdventureWorks2022"

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 = "AdventureWorks2022";
string subscriberName = subscriberInstance;
string subscriptionDbName = "AdventureWorks2022Replica";

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 = "AdventureWorks2022"
Dim subscriberName As String = subscriberInstance
Dim subscriptionDbName As String = "AdventureWorks2022Replica"

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

参照

Best Practices for Replication Administration

次の方法で共有

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

データ検証の動作

注意点と制約

データ検証の結果

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

SQL Server Management Studio を使用する

Transact-SQL の使用

すべてのアーティクル

単一のアーティクル

単一のサブスクライバー

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

レプリケーションモニターの使用

マージパブリケーションの単一のサブスクリプション

SQL Server Management Studio を使用する

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

SQL Server Management Studio を使用する

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

レプリケーションモニターの使用

Transact-SQL の使用

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

レプリケーションモニターの使用

Transact-SQL の使用

マージエージェントのパラメーターを使用したデータの検証

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

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

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

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

例 (RMO)

参照

フィードバック

その他のリソース

次の方法で共有

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

データ検証の動作

注意点と制約

データ検証の結果

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

SQL Server Management Studio を使用する

Transact-SQL の使用

すべてのアーティクル

単一のアーティクル

単一のサブスクライバー

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

レプリケーション モニターの使用

マージ パブリケーションの単一のサブスクリプション

SQL Server Management Studio を使用する

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

SQL Server Management Studio を使用する

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

レプリケーション モニターの使用

Transact-SQL の使用

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

レプリケーション モニターの使用

Transact-SQL の使用

マージ エージェントのパラメーターを使用したデータの検証

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

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

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

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

例 (RMO)

参照

フィードバック

その他のリソース

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

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

レプリケーションモニターの使用

マージパブリケーションの単一のサブスクリプション

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

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

レプリケーションモニターの使用

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

レプリケーションモニターの使用

マージエージェントのパラメーターを使用したデータの検証

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

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

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