翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# を使用した Java アプリケーションの SQL コードの変換 AWS Schema Conversion Tool
<a name="CHAP_Converting.App.Java"></a>

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

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

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

## での Java アプリケーション変換プロジェクトの作成 AWS SCT
<a name="CHAP_Converting.App.Java.Create"></a>

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

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

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

1. データベース変換プロジェクトを作成し、ソース Oracle データベースを追加します。詳細については、「[でのプロジェクトの開始と管理 AWS SCT](CHAP_UserInterface.Project.md)」および「[でプロジェクトにサーバーを追加する AWS SCT](CHAP_UserInterface.AddServers.md)」を参照してください。

1. ソース Oracle データベースとターゲット PostgreSQL データベースを含むマッピングルールを追加します。マッピングルールでターゲット PostgreSQL データベースを追加するか、仮想 PostgreSQL ターゲットデータベースプラットフォームを使用できます。詳細については、「[AWS Schema Conversion Tool でのデータ型のマッピング](CHAP_Mapping.md)」および「[AWS Schema Conversion Tool の仮想ターゲットへのマッピング](CHAP_Mapping.VirtualTargets.md)」を参照してください。

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

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

   [**新しいアプリケーション変換プロジェクト**] ダイアログボックスが表示されます。  
![\[[新しい Java アプリケーション変換プロジェクト] ダイアログボックス\]](http://docs.aws.amazon.com/ja_jp/SchemaConversionTool/latest/userguide/images/java-application-new-project.png)

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

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

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

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

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

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

## での Java アプリケーション SQL コードの変換 AWS SCT
<a name="CHAP_Converting.App.Java.Convert"></a>

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

**SQL コードを変換するには**

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

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

1.  **Convert**. AWS SCT analyzes your source code files, determine the application logic, and loads code metadata into the project を選択します。このコードメタデータには、Java クラス、オブジェクト、メソッド、グローバル変数、インターフェイスなどが含まれます。

   ターゲットデータベースパネルで、 はソースアプリケーションプロジェクトと同様のフォルダ構造 AWS SCT を作成します。変換されたアプリケーションコードをここで確認できます。  
![\[分析する SQL コード\]](http://docs.aws.amazon.com/ja_jp/SchemaConversionTool/latest/userguide/images/java-applications-project-analyze.png)

1. 変換したアプリケーションコードを保存します。詳細については、「[変換されたアプリケーションコードを保存する](#CHAP_Converting.App.Java.Save)」を参照してください。

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

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

## で変換したアプリケーションコードを保存する AWS SCT
<a name="CHAP_Converting.App.Java.Save"></a>

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

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

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

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

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

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

## での Java アプリケーション変換プロジェクトの管理 AWS SCT
<a name="CHAP_Converting.App.Java.Manage"></a>

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

## での Java アプリケーション変換評価レポートの作成 AWS SCT
<a name="CHAP_Converting.App.Java.AssessmentReport"></a>

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

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

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

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

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

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

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

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

   以下に示している [**概要**] タブには、Java アプリケーション評価レポートの要約が表示されます。すべての SQL 実行ポイントとすべてのソースコードファイルの変換結果が表示されます。  
![\[Java アプリケーション評価レポートの [概要] タブ\]](http://docs.aws.amazon.com/ja_jp/SchemaConversionTool/latest/userguide/images/java-applications-summary.png)

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

1. （オプション） レポートのローカル コピーを PDF ファイルまたはカンマ区切り値 (CSV) ファイルとして保存します。
   + 右上の [**PDF に保存**] を選択して、レポートを PDF ファイルとして保存します。

      PDF ファイルには、エグゼクティブサマリー、アクション項目、アプリケーション変換に関する推奨事項が含まれています。
   + 右上の [**CSV に保存**] を選択して、レポートを CSV ファイルとして保存します。

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