トラブルシューティングツール: SQL Server トランザクションレプリケーションでのエラーを見つける

2025-06-12

適用対象:SQL Server Azure SQL Managed Instance

トランザクションレプリケーションがどのように動作するのかを基本的に理解していないと、レプリケーションエラーのトラブルシューティングはフラストレーションを感じることがあります。パブリケーション作成の最初のステップは、スナップショットエージェントでスナップショットを作成し、スナップショットフォルダーにそれを保存することです。次に、ディストリビューションエージェントがサブスクライバーにスナップショットを適用します。

このプロセスでは、パブリケーションが作成されて、"同期" 状態にされます。同期は次の 3 つのフェーズで動作します。

レプリケートされるオブジェクトでトランザクションが発生し、トランザクションログで "レプリケーション用" とマークされます。
ログリーダーエージェントがトランザクションログをスキャンし、"レプリケーション用" とマークされたトランザクションを探します。これらのトランザクションは、ディストリビューションデータベースに保存されます。
ディストリビューションエージェントは、リーダースレッドを使用してディストリビューションデータベースをスキャンします。次に、ライタースレッドを使用することにより、このエージェントはサブスクライバーに接続して、変更をサブスクライバーに適用します。

このプロセスのどのステップにおいてもエラーが発生する可能性があります。これらのエラーを見つけることは、同期に関する問題のトラブルシューティングの最も困難な側面です。レプリケーションモニターを使うとこのプロセスが簡単になります。

注

このトラブルシューティングガイドの目的は、トラブルシューティングの手法を説明することです。特定のエラーを解決することではなく、レプリケーションでのエラーの発見に関する一般的なガイダンスを提供することを目的として作成されています。具体的な例がいくつか示されていますが、それらの解決方法は環境によって異なる場合があります。エラーの例は、「チュートリアル: 完全に接続された 2 つのサーバー (トランザクション) 間のレプリケーションを構成する」チュートリアルに基づいています。

トラブルシューティングの手法

確認事項

同期プロセスのどこでレプリケーションが失敗するか。
どのエージェントでエラーが発生するか。
レプリケーションが最後に正常に動作したのはいつか。その後で何か変更したか。

実行する手順

レプリケーションモニターを使用して、レプリケーションでエラーが発生した時点 (どのエージェントか) を特定します。
- パブリッシャーからディストリビューターまでセクションでエラーが発生している場合は、ログリーダーエージェントに関する問題です。
- ディストリビューターからサブスクライバーまでセクションでエラーが発生している場合は、ディストリビューションエージェントに関する問題です。
ジョブの利用状況モニターでそのエージェントのジョブ履歴を調べて、エラーの詳細を明らかにします。ジョブ履歴に十分な詳細が表示されない場合は、その特定のエージェントで詳細ログを有効にすることができます。
エラーの解決方法の決定を試みます。

スナップショットエージェントでエラーを見つける

スナップショットエージェントは、スナップショットを生成し、それを指定されたスナップショットフォルダーに書き込みます。

スナップショットエージェントの状態を表示します。
1. オブジェクトエクスプローラーで、[レプリケーション] の下の [ローカルパブリケーション] ノードを展開します。
2. AdvWorksProductTrans パブリケーションを右クリックして、> をクリックします。
スナップショットエージェントの状態でエラーが報告された場合は、スナップショットエージェントのジョブ履歴で詳細を確認することができます。
1. オブジェクトエクスプローラーで [SQL Server エージェント] を展開し、[ジョブの利用状況モニター] を開きます。
2. [カテゴリ] で並べ替えて、カテゴリ REPL-Snapshot でスナップショットエージェントを識別します。
3. そのスナップショットエージェントを右クリックして、[履歴の表示] を選択します。
スナップショットエージェントの履歴で、関連するログエントリを選択します。これは、通常、エラーが報告されているエントリの 1 または 2 行 "前" にあります。 (赤い X はエラーを示します。) ログの下にあるボックス内のメッセージテキストを確認してください。
```
The replication agent had encountered an exception.
Exception Message: Access to path '\\node1\repldata.....' is denied.
```

Windows のアクセス許可がスナップショットフォルダーに対して正しく構成されていない場合は、スナップショットエージェントの "アクセスが拒否されました" というエラーが表示されます。スナップショットが格納されているフォルダーへのアクセス許可を確認し、スナップショットエージェントの実行に使用されるアカウントに共有へのアクセス許可があることを確認する必要があります。

ログリーダーエージェントでエラーを見つける

ログリーダーエージェントは、パブリッシャーデータベースに接続し、トランザクションログをスキャンして、"レプリケーション用" とマークされているトランザクションを探します。次に、それらのトランザクションをディストリビューションデータベースに追加します。

SQL Server Management Studio でパブリッシャーに接続します。サーバーノードを展開して [レプリケーション] フォルダーを右クリックし、[レプリケーションモニターの起動] を選択します。

レプリケーションモニターが開きます。
赤い X は、パブリケーションが同期されていないことを示します。左側で [マイパブリッシャー] を展開し、関連するパブリッシャーサーバーを展開します。
左側で AdvWorksProductTrans パブリケーションを選択し、いずれかのタブで赤い X 印を探して、どこに問題があるかを特定します。この場合、赤い X 印は [エージェント] タブにあるので、エージェントの 1 つでエラーが発生しています。
[エージェント] タブを選択し、どのエージェントでエラーが発生しているかを特定します。
この表示では、スナップショットエージェントとログリーダーエージェントの 2 つのエージェントが示されています。エラーが発生しているものに赤い X 印が付いています。この例ではログリーダーエージェントです。

エラーが報告されている行をダブルクリックして、ログリーダーエージェントのエージェント履歴を開きます。この履歴では、エラーに関する詳細情報が提供されます。
```
Status: 0, code: 20011, text: 'The process could not execute 'sp_replcmds' on 'NODE1\SQL2016'.'.
The process could not execute 'sp_replcmds' on 'NODE1\SQL2016'.
Status: 0, code: 15517, text: 'Cannot execute as the database principal because the principal "dbo" does not exist, this type of principal cannot be impersonated, or you do not have permission.'.
Status: 0, code: 22037, text: 'The process could not execute 'sp_replcmds' on 'NODE1\SQL2016'.'.
```
このエラーは通常、パブリッシャーデータベースの所有者が正しく設定されていない場合に発生します。これは、データベースが復元されるときに発生することがあります。これを確認するには、次のようにします。
1. オブジェクトエクスプローラーで [データベース] を展開します。
2. [AdventureWorks2022] を右クリックして、> をクリックします。
3. [ファイル] ページの下に所有者が存在することを確認します。このボックスが空白の場合は、これが問題の原因と考えられます。

[ファイル] ページで所有者が空白の場合は、データベースのコンテキスト内の AdventureWorks2022 ウィンドウを開きます。次の T-SQL コードを実行します。

-- set the owner of the database to 'sa' or a specific user account, without the brackets.
EXECUTE sp_changedbowner '<useraccount>';
-- example for sa: exec sp_changedbowner 'sa'
-- example for user account: exec sp_changedbowner 'sqlrepro\administrator'

ログリーダーエージェントの再起動が必要な場合があります。
1. オブジェクトエクスプローラーで [SQL Server エージェント] ノードを展開し、ジョブの利用状況モニターを開きます。
2. [カテゴリ] で並べ替え、REPL-LogReader カテゴリによってログリーダーエージェントを識別します。
3. ログリーダーエージェント ジョブを右クリックし、[Start Job at Step]\(ステップでジョブを開始\) を選択します。
レプリケーションモニターをもう一度開いて、パブリケーションが現在同期されていることを確認します。まだ開いていない場合は、オブジェクトエクスプローラーで [レプリケーション] を右クリックして見つけることができます。
AdvWorksProductTrans パブリケーション、[エージェント] タブの順に選択し、ログリーダーエージェントをダブルクリックして、エージェントの履歴を開きます。これで、ログリーダーエージェントが実行中で、コマンドをレプリケートしているか、"レプリケートされたトランザクションが存在しない" のいずれかが示されるはずです。

ディストリビューションエージェントでエラーを見つける

ディストリビューションエージェントは、ディストリビューションデータベースでデータを見つけて、それをサブスクライバーに適用します。

SQL Server Management Studio でパブリッシャーに接続します。サーバーノードを展開して [レプリケーション] フォルダーを右クリックし、[レプリケーションモニターの起動] を選択します。
[レプリケーションモニター] で、[AdvWorksProductTrans] パブリケーションを選択し、[すべてのサブスクリプション] タブを選択します。サブスクリプションを右クリックして [詳細表示] を選択します。

[ディストリビューターからサブスクライバーまで] 履歴ダイアログボックスが開き、エージェントで発生しているエラーの内容を明確にします。

ディストリビューションエージェントのエラーの詳細のスクリーンショット。

Error messages:
Agent 'NODE1\SQL2016-AdventureWorks2022-AdvWorksProductTrans-NODE2\SQL2016-7' is retrying after an error. 89 retries attempted. See agent job history in the Jobs folder for more details.

このエラーは、ディストリビューションエージェントが再試行していることを示します。詳細情報を探すには、ディストリビューションエージェントのジョブ履歴を確認します。
1. オブジェクトエクスプローラーで [SQL Server エージェント] を展開し、> を開きます。
2. [カテゴリ] でジョブを並べ替えます。
3. カテゴリ REPL-Distribution でディストリビューションエージェントを識別します。エージェントを右クリックして、[履歴の表示] を選択します。

いずれかのエラーエントリを選択し、ウィンドウの下部にエラーテキストを表示します。

Message:
Unable to start execution of step 2 (reason: Error authenticating proxy NODE1\repl_distribution, system error: The user name or password is incorrect.)

このエラーは、ディストリビューションエージェントで使用されたパスワードが正しくないことを示しています。これを解決するには次のようにします。
1. オブジェクトエクスプローラーで [レプリケーション] のノードを展開します。
2. サブスクリプションを右クリックして、> をクリックします。
3. [エージェントプロセスアカウント] の横にある省略記号 [...] を選択して、パスワードを変更します。
オブジェクトエクスプローラーで [レプリケーション] を右クリックして、レプリケーションモニターをもう一度確認します。 [すべてのサブスクリプション] の下の赤い X 印は、ディストリビューションエージェントでまだエラーが発生していることを示します。

[レプリケーションモニター] でサブスクリプションを右クリックして [詳細表示] を選択し、> の履歴を開きます。ここでは、異なるエラーが表示されるようになります。
```
Connecting to Subscriber 'NODE2\SQL2016'
Agent message code 20084. The process could not connect to Subscriber 'NODE2\SQL2016'.
Number:  18456
Message: Login failed for user 'NODE2\repl_distribution'.
```
このエラーは、ユーザー NODE2\repl_distribution のログインに失敗したため、ディストリビューションエージェントがサブスクライバーに接続できなかったことを示します。さらに詳しく調べるには、サブスクライバーに接続して、オブジェクトエクスプローラーで [管理] ノードの下の現在の SQL Server エラーログを開きます。

このエラーが表示される場合は、ログインがサブスクライバー上にありません。このエラーを解決するには、「レプリケーションのセキュリティロールの要件」を参照してください。
ログインエラーが解決された後、もう一度レプリケーションモニターを確認してください。すべての問題が解決されると、[パブリケーション名] の横に緑色の矢印が表示され、[すべてのサブスクリプション] の下の状態が [実行中] になります。

サブスクリプションを右クリックして [ディストリビューターからサブスクライバーまで] 履歴をもう一度開き、成功したことを確認します。ディストリビューションエージェントを初めて実行する場合は、スナップショットがサブスクライバーに一括コピーされていることがわかります。

マージエージェントでエラーを見つける

マージエージェントは、変更のレプリケートに長い時間がかかる場合があります。マージレプリケーション同期プロセスのどのステップに最も時間がかかるかを判断するには、トレースフラグ 101 とマージエージェントのログ記録を使用します。これを行うには、マージエージェントパラメーターとして次のパラメーターを使用して、エージェントを再起動します:

-T 101
-output
-outputverboselevel

注

<distribution-server>..msmerge_history テーブルに統計を書き込む必要がある場合は、トレースフラグ 102 を使用します。

マージレプリケーションの同期が完了した後のマージエージェントの出力例を次に示します。

**************************************************************
CONNECTION TIMES --> time took to establish the connection to the servers. Publisher (all connections) 156 msec   Subscriber (all connections) 32 msec Distributor 93 msec
**************************************************************
UPLOAD COUNTERS  --> upload phase (changes from the Sub to the Pub) stats MakeGeneration Time = 343 msec. InsertGenHistory Time = 31 msec. UpdateGenHistory Time = 0 msec. ProxiedMetadata Time = 0 msec.
**************************************************************
DOWNLOAD COUNTERS  --> download phase (changes from the Pub to the Sub) stats MakeGeneration Time = 219 msec. InsertGenHistory Time = 0 msec. UpdateGenHistory Time = 0 msec.
**************************************************************
RETENTION-BASED CLEANUP STATISTICS --> sp_mergemetadataretentioncleanup proc stats Publisher: Cleanup Time 281 msec MSmerge_genhistory rows cleaned up 0 MSmerge_contents rows cleaned up 0 MSmerge_tombstone rows cleaned up 0 Subscriber: Cleanup Time 187 msec MSmerge_genhistory rows cleaned up 0 MSmerge_contents rows cleaned up 0 MSmerge_rowtrack rows cleaned up 0 MSmerge_tombstone rows cleaned up 0
**************************************************************
RETRY STATISTICS Retry Time (Upload) 0 msec. Retry Time (Download) 0 msec. Total changes retried 0 Number of Iterations through rows needing retry 0 Total number of changes that failed despite retry 0
**************************************************************
PROXY METADATA QUEUE COUNTERS Queue Full: Number of Waits: 0, Total Wait Time: 0 msec
**************************************************************
Distributor-side History Logging Time = 219 msec. Number of Distributor-side History Messages Logged = 11 Subscriber-side History Logging Time = 295 msec. Number of Subscriber-side History Messages Logged = 11
**************************************************************
2013-05-28 17:24:11.820 OLE DB Subscriber '<SQL Server name>\sql2008r2': DBCC SQLPERF (NETSTATS)  2013-05-28 17:24:11.822 OLE DB Publisher '<SQL Server name>\SQL2008R2':  DBCC SQLPERF (NETSTATS)  2013-05-28 17:24:11.824 OLE DB Distributor '<SQL Server name>\SQL2008R2':  DBCC SQLPERF (NETSTATS)  NETWORK STATISTICS Server  Reads  Writes  Bytes Read Bytes Written Publisher 74  74  19112  37526 Subscriber 73  73  19032  36931 Distributor 75  75  19192  38121
**************************************************************
NETWORK STATUS Network Connection: The computer has one or more LAN cards that are active. Network link speed: Destination Incoming  Outgoing Publisher Unreachable  Unreachable Subscriber Unreachable  Unreachable Distributor Unreachable  Unreachable
**************************************************************

エージェントで詳細ログを有効にする

詳細ログを使用して、レプリケーショントポロジ内のエージェントで発生したエラーに関する詳細な情報を見ることができます。手順はどのエージェントでも同じです。ジョブの利用状況モニターで正しいエージェントを選択していることだけを確認してください。

注

プルサブスクリプションかプッシュサブスクリプションかに応じて、エージェントはパブリッシャーかサブスクライバーのどちらにある可能性もあります。調査中のサーバーでエージェントを使用できない場合は、もう一方のサーバーをチェックします。

詳細ログを保存するかどうかを決めて、フォルダーが存在することを確認します。この例では c:\temp を使います。
オブジェクトエクスプローラーで [SQL Server エージェント] ノードを展開し、ジョブの利用状況モニターを開きます。
[カテゴリ] で並べ替えて、関心のあるエージェントを見つけます。この例では、ログリーダーエージェントを使います。関心のあるエージェントを右クリックして、> をクリックします。
[ステップ] ページを選択し、[エージェントを実行します] ステップを強調表示にします。編集を選択します。
[コマンド] ボックスで新しい行を開始し、次のテキストを入力して、[OK] を選択します。
```
-Output C:\Temp\OUTPUTFILE.txt -Outputverboselevel 3
```
必要に応じて、場所と詳細レベルを変更できます。

詳細出力パラメーターを追加すると、次の問題が発生してエージェントが失敗したり、アウトファイルファイルが見つからない可能性があります。
- 書式設定に問題があり、ダッシュがハイフンになっています。
- ディスク上に場所が存在しません。または、エージェントを実行しているアカウントに、指定した場所に書き込むアクセス許可がありません。
- 最後のパラメーターと -Output パラメーターの間にスペースがありません。
- エージェントにより、サポートされる詳細さのレベルが異なります。詳細ログを有効にしてもエージェントが起動しない場合は、指定した詳細レベルを 1 つ下げて再試行してください。
エージェントを右クリックして > (ステップでジョブを停止) を選択し、ログリーダーエージェントを再起動します。ツールバーの [更新] アイコンを選択して更新します。エージェントを右クリックして、> (ステップでジョブを開始) を選択します。
ディスクで出力を確認します。
詳細ログを無効にするには、前と同じ手順に従い、前に追加した -Output 行全体を削除します。