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

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

適用対象: SQL Server Azure SQL Managed Instance

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

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

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

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

Note

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

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

確認事項

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

実行する手順

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

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

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

スナップショットエージェントの状態を表示します。

a. オブジェクトエクスプローラーで、[レプリケーション] の下の [ローカルパブリケーション] ノードを展開します。

b. AdvWorksProductTrans パブリケーションを右クリックして、[スナップショットエージェントの状態の表示] をクリックします。
スナップショットエージェントの状態でエラーが報告された場合は、スナップショットエージェントのジョブ履歴で詳細を確認することができます。

a. オブジェクトエクスプローラーで [SQL Server エージェント] を展開し、[ジョブの利用状況モニター] を開きます。

b. [カテゴリ] で並べ替えて、カテゴリ REPL-Snapshot でスナップショットエージェントを識別します。

c. そのスナップショットエージェントを右クリックして、[履歴の表示] を選択します。
スナップショットエージェントの履歴で、関連するログエントリを選択します。これは、通常、エラーが報告されているエントリの 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'.'.        
```
エラーは、通常、パブリッシャーデータベースの所有者が正しく設定されていないときに発生します。これは、データベースが復元されるときに発生することがあります。これを確認するには、次のようにします。

a. オブジェクトエクスプローラーで [データベース] を展開します。

b. [AdventureWorks2022] を右クリックして、[Properties] をクリックします。

c. [ファイル] ページの下に所有者が存在することを確認します。このボックスが空白の場合は、これが問題の原因と考えられます。

[ファイル] ページで所有者が空白の場合は、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'

ログリーダーエージェントの再起動が必要な場合があります。

a. オブジェクトエクスプローラーで [SQL Server エージェント] ノードを展開し、ジョブの利用状況モニターを開きます。

b. [カテゴリ] で並べ替え、REPL-LogReader カテゴリによってログリーダーエージェントを識別します。

c. ログリーダーエージェント ジョブを右クリックし、[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.

このエラーは、ディストリビューションエージェントが再試行していることを示します。詳細情報を探すには、ディストリビューションエージェントのジョブ履歴を確認します。

a. オブジェクトエクスプローラーで [SQL Server エージェント] を展開し、[ジョブの利用状況モニター] を開きます。

b. [カテゴリ] でジョブを並べ替えます。

c. カテゴリ 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.)

このエラーは、ディストリビューションエージェントで使用されたパスワードが正しくないことを示しています。これを解決するには次のようにします。

a. オブジェクトエクスプローラーで [レプリケーション] のノードを展開します。

b. サブスクリプションを右クリックして、[プロパティ] をクリックします。

c. [エージェントプロセスアカウント] の横にある省略記号 [...] を選択して、パスワードを変更します。
オブジェクトエクスプローラーで [レプリケーション] を右クリックして、レプリケーションモニターをもう一度確認します。 [すべてのサブスクリプション] の下の赤い 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 エラーログを開きます。

このエラーが表示される場合は、ログインがサブスクライバー上にありません。このエラーを解決するには、レプリケーションのためのアクセス許可に関するページをご覧ください。
ログインエラーが解決された後、もう一度レプリケーションモニターを確認してください。すべての問題が解決されると、[パブリケーション名] の横に緑色の矢印が表示され、[すべてのサブスクリプション] の下の状態が [実行中] になります。

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

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

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

Note

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

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

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