Oracle から AlloyDB for PostgreSQL への移行に関する問題を診断する

このページでは、次の既知のエラーと推奨されるトラブルシューティングの手順について説明します。

移行ジョブ中に発生したエラー
ネットワーク接続の確立時に発生する問題
Oracle SCAN の使用時に発生するエラー

移行ジョブのエラー

移行ジョブプロセスでは、ランタイム中にエラーが発生することがあります。

エラーには、ソースデータベースの不正なパスワードなど、回復可能なものもあります。これらのエラーが修正されると、移行ジョブは自動的に再開されます。
データレプリケーションのエラーなど、回復できないエラーもあります。これらのエラーが修正されたら、移行ジョブを再起動する必要があります。

エラーが発生すると、移行ジョブのステータスが Failed に変わり、サブステータスには失敗前の最後のステータスが反映されます。エラーのトラブルシューティングを行うには、失敗した移行ジョブに移動してエラーを表示し、エラーメッセージに記載されている手順に沿って操作します。エラーの詳細を表示するには、移行ジョブのリンクを使用して Cloud Monitoring に移動します。ログは特定の移行ジョブにフィルタリングされます。

次の表に、問題とその解決方法の例を示します。

症状	考えられる原因	次の方法をお試しください
エラーメッセージ: `Database Migration Service can't set up a tunnel to be connected to the bastion host`。	Database Migration Service が踏み台インスタンスにアクセスできなかったか、踏み台インスタンスが接続を受け入れていません。	ソース接続プロファイルと SSH トンネルサーバー構成で転送 SSH トンネルの設定を確認してから、もう一度お試しください。
エラーメッセージ: `Database Migration Service can't connect to the database` または `Database Migration Service private connectivity error, cannot connect to the database`。	Database Migration Service は、移行元 Oracle データベースへの接続を確立できませんでした。	プロジェクトからソースデータベースにアクセスできることを確認します。移行元の接続構成方法に関連する設定を確認します。特定の Oracle エラーコード（`ORA-12170: TNS:Connect timeout occurred` など）が含まれている場合は、 Oracle のドキュメントで詳細を確認してください。
エラーメッセージ: `Archiving mode is not ARCHIVELOG`	ソースデータベースが `ARCHIVELOG` モードで実行されていません。	`ARCHIVELOG` モードを使用するように移行元データベースを構成します。詳細については、移行元 Oracle データベースを構成するをご覧ください。
エラーメッセージ: `Supplemental logging ("ALL COLUMN LOGGING") isn't turned on for the tables listed below`。	ソースデータベースでサプリメンタルログデータが有効になっていません。	追加ログデータを有効にして、モードを `ALL` に設定します。詳細については、移行元 Oracle データベースを構成するをご覧ください。
エラーメッセージ: `No Archive Log Files were found in the source`	Database Migration Service はクローズされたアーカイブログのみを読み取りますが、移行元データベースでログが見つかりませんでした。	移行元データベースで次のコマンドを実行して、現在のログファイルを閉じます。`ALTER SYSTEM SWITCH LOGFILE` ログをもう一度探してみてください。データベースにアクティブな書き込みオペレーションがない場合は、ログの作成をトリガーするために、少なくとも 1 つの `INSERT` オペレーションを実行する必要があります。
エラーメッセージ: `We're missing the necessary permissions to read from the source`。	移行元データベースの移行ユーザーアカウントに必要な権限がありません。	Database Migration Service は、移行元接続プロファイルで構成したユーザーアカウントとして移行元に接続します。このアカウントには、ソースデータベースのデータを読み取るための特定の権限セット（`SELECT ANY TABLE` など）が必要です。移行ユーザーアカウントに必要な権限があることを確認します。詳細については、移行元 Oracle データベースを構成するをご覧ください。
エラーメッセージ: `Unable to connect to the destination database`	宛先データベースへの接続中に問題が発生しました。	プロジェクトから宛先データベースにアクセスできることを確認します。宛先接続構成方法に関連する設定を確認します。
エラーメッセージ: `The following tables don't exist in the destination database: {table_names}`	移行しようとしているテーブルが、移行先のデータベースに存在しません。	Database Migration Service は、移行元スキーマを変換するときに必要なテーブルと定義を作成します。
エラーメッセージ: `password authentication failed for user {username}`	移行先データベースのユーザー名またはパスワードが正しく構成されていない。	移行先の PostgreSQL 接続プロファイルが正しいユーザー名とパスワードで正しく構成されていることを確認します。
エラーメッセージ: `The following tables in the destination database don't have primary keys: {table_names}`。	エラーメッセージに記載されているテーブルは宛先データベースに存在しますが、主キーがありません。	Database Migration Service の変換ワークスペースでは、スキーマを変換するときに、主キーのないテーブルに主キーが自動的に追加されます。以前のコンバージョンワークスペースを使用する場合は、宛先で主キーを手動で作成する必要があります。詳細については、以前のコンバージョンワークスペースをご覧ください。
警告: `The following tables have foreign keys: {table_names}`。	エラーメッセージにリストされているテーブルは宛先データベースに存在しますが、外部キーがあります。	Database Migration Service はトランザクション方式でデータを複製しないため、テーブルが順序どおりに移行されない可能性があります。外部キーが存在し、外部キーを使用する子テーブルが親テーブルより先に移行されると、レプリケーションエラーが発生する可能性があります。このようなデータ整合性の問題を回避するには、移行ユーザーの `REPLICATION` オプションを使用して外部キーをスキップします。詳細については、外部キーとトリガーに関する考慮事項をご覧ください。
エラーメッセージ: `Unable to resume replication as log position is lost`	このエラーは、レプリケーションプロセスが長時間一時停止され、ログの位置が失われた場合に発生することがあります。	移行ジョブは、ログの保持期間を超える（またはそれに近い）期間一時停止しないでください。ログ位置が失われた場合は、移行ジョブを再作成する必要があります。
エラーメッセージ: `ORA-00942: table or view does not exist`	このエラーは、Oracle サーバーでのキャッシュ保存の結果として発生することがあります。	データベースユーザーを再作成して、キャッシングの問題を解決します。
移行ジョブは完全ダンプフェーズのままで、変更データキャプチャ（CDC）フェーズに進みません。	Database Migration Service が一部のテーブルの完全ダンプをまだ実行しているか、エラーが発生したため 1 つ以上のテーブルの完全ダンプを完了できません。	移行ジョブのエラーを確認し、テーブルに適用されるエラーを修正するか、関連するテーブルをジョブから削除します。 Database Migration Service のログで進行中のフルダンプアクティビティを確認し、完了するまで待ちます。

接続に関する問題

このセクションでは、ネットワーク接続に関する潜在的な問題のトラブルシューティング手順について説明します。

移行先データベースに接続できません: EOF

接続テストを実行すると、[DATABASE] unable to connect to the destination database: EOF エラーメッセージが返されます。

考えられる原因: サービスアタッチメントが正しく構成されていません。

試すこと: サービスアタッチメントの Terraform 構成ファイルで、enable_proxy_protocol が false に設定されていることを確認します。プロキシプロトコルは、NGINX や Apache などの HTTP サーバーでのみサポートされています。

gcloud を使用して Private Service Connect の設定を作成する場合、プロキシプロトコルはデフォルトで無効になっています。

接続タイムアウト、接続拒否

接続テストの実行が失敗するか、タイムアウトします。これは、Private Service Connect の設定内のルーティングの構成が誤っていることが原因である可能性が最も高いです。この問題にはいくつかの原因が考えられます。

考えられる原因: Private Service Connect NAT CIDR 範囲が踏み台インスタンスが配置されている Private Service Connect サブネット（具体的には踏み台インスタンス VM nic0 インターフェース）にアクセスできるようにするファイアウォールルールがありません。

試すこと: 組織のポリシーで、内部ファイアウォールルール（ PSC 対応でない AlloyDB for PostgreSQL インスタンスの宛先プライベート IP 接続の構成の Terraform スクリプトの例で定義されている psc_sp_in_fw ファイアウォールルールなど）が制限されていないことを確認します。

考えられる原因: プロキシがダウンしている。指定されたポートにリスナーがないため、接続がハングします。

試すこと: 踏み台 VM への SSH 接続を確立し、次のコマンドを使用してプロキシを検索できます。

netstat -tunalp | grep PORT

コマンドに対するレスポンスを分析します。

空のレスポンスが返された場合は、プロキシがダウンしています。次のコマンドを実行してみてください。

sudo su; cd / を実行し、sudo dpkg -s dante-server を実行して Dante サーバーがインストールされているかどうかを確認します。
- プロキシがインストールされている場合は、次のメッセージが表示されます。
  
  Status: install ok installed
- プロキシがインストールされていない場合は、ルーターが見つからないことが原因である可能性があります。ルーターを追加し、apt-get install dante-server を実行してプロキシをダウンロードできるかどうかを確認します。
  
  ルーターを追加する方法については、 PSC が有効になっていない AlloyDB for PostgreSQL インスタンスの宛先プライベート IP 接続を構成するの main.tf ファイルで psc_sp_ex_router リソースと psc_sp_ex_router_nat リソースが追加される方法を確認してください。
プロキシが実行中で、指定されたポートでリッスンしている場合は、次の手順で接続を開いてみてください。
1. PostgreSQL クライアントをインストールします。
  
  sudo apt-get install postgresql-client。
2. PostgreSQL データベースに接続します。
  
  psql -h 127.0.0.1 -p PORT -U DBUSERNAME -W（パスワードの入力を求められます）。
  
  次のように置き換えます。
  - PORT: データベースのポート番号。
  - DBUSERNAME: PostgreSQL データベースへの接続に使用するユーザー名。
3. telnet クライアントをインストールします。
  
  sudo apt-get install telnet
4. telnet クライアントに接続します。
  
  telnet 127.0.0.1 PORT
  
  PORT は、データベースのポート番号に置き換えます。
コマンドの結果に応じて、次の対応を行います。
- コマンドで接続を開けない場合は、プロキシログを確認して根本原因を特定します。根本原因は、AlloyDB for PostgreSQL インスタンスの設定によって異なります。
- telnet を使用して接続が開いているにもかかわらずクライアントでハングアップする場合は、踏み台インスタンスの IP アドレスのルーティングが問題である可能性があります。VM のターミナルで ip route と入力します。セカンダリ nic（nic1、DB_SUBNETWORK_GATEWAY IP アドレス）を使用して AlloyDB for PostgreSQL インスタンスのプライベート IP アドレスに接続を転送するルーティングルールを見つけられるかどうかを確認します。

考えられる原因: サービスアタッチメントが、Database Migration Service からのエンドポイント接続を受け入れません。サービスアタッチメントには、承認されたプロジェクトのリストが保持されていますが、Database Migration Service プロジェクトがリストに含まれていません。

解決策: この問題を解決するには、次のいずれかを試してください。

Google Cloud コンソールで、[Private Service Connect] に移動します。

Private Service Connect に移動

[公開済みサービス] タブで、サービスアタッチメントに対する Database Migration Service からの接続を承認します（保留中の場合）。
リクエスト元のプロジェクトをサービスアタッチメントの許可リストに登録されているプロジェクトに追加します（拒否された場合）。
- Terraform で許可リストに登録されたプロジェクトを追加する方法については、 Terraform のドキュメントをご覧ください。
- gcloud で許可リストに登録されたプロジェクトを追加する方法については、 Google Cloud CLI リファレンスドキュメントをご覧ください。
それでも問題が解決しない場合は、接続プロファイルを再作成します。
Private Service Connect 接続に関連付けられている接続プロファイルを削除し、再作成します。

Oracle SCAN エラーのトラブルシューティング

このセクションでは、単一クライアントアクセス名（SCAN）機能を使用して Oracle Real Application Clusters（RAC）ソースから移行する際に発生する可能性のある問題について説明します。

Oracle SCAN データベースへの接続を確立できない

接続テストの実行が失敗するか、タイムアウトする。

考えられる原因: Oracle SCAN ソースデータベースに直接接続しようとしている可能性があります。Database Migration Service は、Oracle RAC 環境の SCAN 機能を使用するデータベースへの直接接続をサポートしていません。