AWS SCT を使用した Java アプリケーションの SQL コードの変換

Oracle から PostgreSQL への変換では、AWS Schema Conversion Tool を使用して Java アプリケーションに埋め込まれた SQL コードを変換できます。この特定の Java アプリケーションコンバータはアプリケーションロジックを理解します。関数、パラメータ、ローカル変数など、さまざまなアプリケーションオブジェクトにあるステートメントを収集します。

この詳細な分析により、Java アプリケーション SQL コードコンバータは、汎用コンバータと比較して優れた変換結果を提供します。

Java アプリケーションが MyBatis フレームワークを使用してデータベースとやり取りする場合、AWS SCT は MyBatis XML ファイルやアノテーションに埋め込まれた SQL ステートメントを変換できます。これらの SQL ステートメントのロジックを理解するには、AWS SCT は MyBatis 設定ファイルを使用します。 AWS SCT は、アプリケーションフォルダ内のこのファイルを自動的に検出できます。また、このファイルへのパスを手動で入力することもできます。

AWS SCT での Java アプリケーション変換プロジェクトの作成

Java アプリケーション変換プロジェクトを作成できるのは、Oracle データベーススキーマを PostgreSQL データベーススキーマに変換する場合に限られます。必ず、ソース Oracle スキーマとターゲット PostgreSQL データベースを含むマッピングルールをプロジェクトに追加してください。詳細については、「AWS SCT でのマッピングルールの作成」を参照してください。

1 つの AWS SCT プロジェクトに複数のアプリケーション変換プロジェクトを追加できます。以下の手順を使用して、Java アプリケーション変換プロジェクトを作成します。

Java アプリケーション変換プロジェクトを作成するには

1. データベース変換プロジェクトを作成し、ソース Oracle データベースを追加します。詳細については、「AWS SCT プロジェクトの作成」および「AWS SCT プロジェクトへのデータベースサーバーの追加」を参照してください。

2. ソース Oracle データベースとターゲット PostgreSQL データベースを含むマッピングルールを追加します。マッピングルールでターゲット PostgreSQL データベースを追加するか、仮想 PostgreSQL ターゲットデータベースプラットフォームを使用できます。詳細については、「AWS SCT でのマッピングルールの作成」および「仮想ターゲットの使用」を参照してください。

3. [ビュー] メニューで、[メインビュー] を選択します。

4. [アプリケーション] メニューで [新しい Java アプリケーション] を選択します。

   [新しいアプリケーション変換プロジェクト] ダイアログボックスが表示されます。

   

5. [名前] に、Java アプリケーション変換プロジェクトの名前を入力します。それぞれのデータベーススキーマ変換プロジェクトごとに 1 つ以上の子アプリケーション変換プロジェクトを作成できるため、後で複数のプロジェクトを追加する場合を考慮した名前を選択します。

6. アプリケーションのソースコードの [場所] を入力します。

7. (オプション) MyBatis 設定ファイルには、MyBatis 設定ファイルへのパスを入力します。 AWS SCT はアプリケーションフォルダをスキャンして、このファイルを自動的に検出します。このファイルがアプリケーションフォルダにない場合や、複数の設定ファイルを使用している場合は、パスを手動で入力します。

8. ソースツリーで、アプリケーションによって使用されるスキーマを選択します。このスキーマが、マッピングルールに含まれていることを確認してください。AWS SCT で、マッピングルールに含まれるスキーマが強調表示されます。

9. [OK] を選択して、Java アプリケーション変換プロジェクトを作成します。

10. 左側のパネルの [アプリケーション] ノードで Java アプリケーション変換プロジェクトを探します。

AWS SCT での Java アプリケーションの SQL コードの変換

Java アプリケーションを AWS SCT プロジェクトに追加したら、このアプリケーションの SQL コードをターゲットデータベースプラットフォームと互換性のある形式に変換します。以下の手順で、AWS Schema Conversion Tool の Java アプリケーションで SQL コードを分析して変換します。

SQL コードを変換するには

1. 左側のパネルの [アプリケーション] の下にある [Java] ノードを展開します。

2. 変換するアプリケーションを選択し、コンテキスト (右クリック) メニューを開きます。

3. [変換] を選択します。 AWS SCT はソースコードファイルを分析し、アプリケーションロジックを決定し、コードメタデータをプロジェクトに読み込みます。このコードメタデータには、Java クラス、オブジェクト、メソッド、グローバル変数、インターフェイスなどが含まれます。

   ターゲットデータベースパネルで、AWS SCT はソースアプリケーションプロジェクトと同様のフォルダ構造を作成します。変換されたアプリケーションコードをここで確認できます。

   

4. 変換したアプリケーションコードを保存します。詳細については、「変換されたアプリケーションコードを保存する」を参照してください。

Java アプリケーションには、さまざまなソースデータベースとやり取りする SQL コードが含まれている場合があります。これらのソースデータベースのいくつかを PostgreSQL に移行できます。この場合、移行範囲から除外したデータベースとやりとりする SQL コードを変換しないようにしてください。Java アプリケーションのソースファイルは変換スコープから除外できます。そのためには、変換スコープから除外するファイル名のチェックボックスをオフにします。

変換スコープを変更した後も、AWS SCT はJava アプリケーションのすべてのソースファイルの SQL コードを分析します。次に、AWS SCT は変換スコープから除外したすべてのソースファイルをターゲットフォルダーにコピーします。この操作により、変換したアプリケーションファイルを保存した後でアプリケーションを構築できます。

変換したアプリケーションコードを AWS SCT で保存します。

次の手順に従って、変換されたアプリケーションコードを保存します。

変換されたアプリケーションコードを保存するには

1. ターゲットデータベースパネルの [アプリケーション] の下の [Java] ノードを展開します。

2. 変換したアプリケーションを選択し、[保存] を選択します。

3. 変換したアプリケーションコードを保存するフォルダへのパスを入力し、[フォルダを選択] を選択します。

ソース Java アプリケーションが MyBatis フレームワークを使用している場合は、新しいデータベースで動作するように、設定ファイルを更新してください。

AWS SCT での Java アプリケーション変換プロジェクトの管理

複数の Java アプリケーション変換プロジェクトを追加したり、AWS SCT プロジェクト内のアプリケーションコードを更新したり、AWS SCT プロジェクトから Java 変換プロジェクトを削除したりできます。

Java アプリケーション変換プロジェクトを追加するには

1. 左パネルの [アプリケーション] ノードを展開します。

2. [Java] ノードを選択して、のコンテキスト (右クリック) メニューを開きます。

3. [新しいアプリケーション] を選択します。

4. 新しい Java アプリケーション変換プロジェクトを作成するのに必要な情報を入力します。詳細については、「Java アプリケーション変換プロジェクトの作成」を参照してください。

ソースアプリケーションコードに変更を加えたら、それを AWS SCT プロジェクトにアップロードします。

アプリケーションコードを更新するには

1. 左側のパネルの [アプリケーション] の下にある [Java] ノードを展開します。

2. 更新するアプリケーションを選択し、コンテキスト (右クリック) メニューを開きます。

3. [更新] を選択し、[はい] を選択します。

   AWS SCT は、ソースファイルからアプリケーションコードをアップロードし、変換結果を削除します。AWS SCT で行ったコード変更と変換結果を保持するには、新しい Java 変換プロジェクトを作成します。

ソース Java アプリケーションが MyBatis フレームワークを使用している場合は、AWS SCT は MyBatis 設定ファイルを使用して SQL コードを解析します。このファイルを変更したら、AWS SCT プロジェクトにアップロードします。

MyBatis 設定ファイルへのパスを編集するには

1. 左側のパネルの [アプリケーション] の下にある [Java] ノードを展開します。

2. アプリケーションを選択後、[設定] を選択します。

3. [参照] を選択し、MyBatis 設定ファイルを選択します。

4. [適用] を選択します。

5. 左側のパネルでアプリケーションを選択し、コンテキスト (右クリック) メニューを開き、[更新] を選択します。

Java アプリケーション変換プロジェクトを削除するには

1. 左側のパネルの [アプリケーション] の下にある [Java] ノードを展開します。

2. 削除するアプリケーションを選択し、コンテキスト (右クリック) メニューを開きます。

3. [削除] を選択し、[OK] を選択します。

AWS SCT での Java アプリケーション変換評価レポートの作成

Java アプリケーション変換評価レポートには、Java アプリケーションに埋め込まれている SQL コードをターゲットデータベースと互換性のある形式に変換する方法に関する情報が記載されています。評価レポートには、すべての SQL 実行ポイントとすべてのソースコードファイルの変換詳細が記載されています。評価レポートには、AWS SCT で変換できない SQL コードのアクションアイテムも含まれています。

以下の手順を使用して、Java アプリケーション評価レポートを作成します。

Java アプリケーション評価レポートを作成するには

1. 左側のパネルの [アプリケーション] の下にある [Java] ノードを展開します。

2. 変換するアプリケーションを選択し、コンテキスト (右クリック) メニューを開きます。

3. [変換] を選択します。

4. [ビュー] メニューで [評価レポートビュー] を選択します。

5. [概要] タブを確認します。

   以下に示している [概要] タブには、Java アプリケーション評価レポートの要約が表示されます。すべての SQL 実行ポイントとすべてのソースコードファイルの変換結果が表示されます。

   

6. Java アプリケーションから抽出した SQL コードを JSON ファイルとして保存するには、[ステートメントを JSON に保存] を選択します。

7. （オプション） レポートのローカル コピーを PDF ファイルまたはカンマ区切り値 (CSV) ファイルとして保存します。

   • 右上の [PDF に保存] を選択して、レポートを PDF ファイルとして保存します。

     PDF ファイルには、エグゼクティブサマリー、アクション項目、アプリケーション変換に関する推奨事項が含まれています。

   • 右上の [CSV に保存] を選択して、レポートを CSV ファイルとして保存します。

     CSV ファイルには、アクションアイテム、推奨アクション、および SQL コードの変換に必要な推定手作業の複雑さが含まれています。