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

# Amazon Q Developer を使用した Java アプリケーションの埋め込み SQL の変換
<a name="transform-sql"></a>

IDE でのコード変換用の Amazon Q Developer エージェントは、 AWS Database Migration Service 埋め込み SQL を (AWS DMS) を使用して Oracle から PostgreSQL データベースへの移行を完了するのに役立ちます。

AWS DMS は、リレーショナルデータベース、データウェアハウス、NoSQL データベース、およびその他のタイプのデータストアを移行できるようにするクラウドサービスです。 AWS DMS の DMS Schema Conversion を使うと、ターゲットデータベースに適用できるようにデータベーススキーマとコードオブジェクトを変換することができます。詳細については、「 *AWS Database Migration Service ユーザーガイド*」の[「What is AWS Database Migration Service?](https://docs.aws.amazon.com/dms/latest/userguide/Welcome.html)」を参照してください。

 AWS DMS および DMS Schema Conversion を使用してデータベースを移行する場合、アプリケーションに埋め込まれた SQL をターゲットデータベースと互換性があるように変換する必要がある場合があります。埋め込み SQL は手動で変換するのではなく、IDE で Amazon Q を使用して自動的に変換できます。Amazon Q は、DMS Schema Conversion のメタデータを使用して、アプリケーションの埋め込み SQL をターゲットデータベースに対応するバージョンに変換します。

現在 Amazon Q では、PostgreSQL に移行する Oracle データベースの Java アプリケーションに埋め込まれた SQL を変換できます。SQL コードを変換するオプションは、アプリケーションに Oracle SQL ステートメントが含まれている場合のみ IDE で 表示されます。詳細については、前提条件を参照してください。

## ステップ 1: 前提条件
<a name="sql-transform-prereqs"></a>

続行する前に、「[IDE で Amazon Q のセットアップ](q-in-IDE-setup.md)」の手順が完了していることを確認してください。

SQL 変換のコード変換ジョブを開始する前に、以下の前提条件を満たしていることを確認します。
+ SQL が埋め込まれた Java アプリケーションを Oracle データベースから PostgreSQL データベースに移行するため、変換の要件を満たすには、アプリケーションに Oracle SQL ステートメントが含まれている必要があります。
+  AWS DMS Schema Conversion を使用してデータベーススキーマを変換するプロセスを済ませておきます。詳細については、「*データベース移行ガイド*」の「[Migrating Oracle databases to Amazon RDS for PostgreSQL with DMS Schema Conversion](https://docs.aws.amazon.com/dms/latest/sbs/schema-conversion-oracle-postgresql.html)」を参照してください。
+ スキーマ変換が完了したら、DMS AWS コンソールから移行プロジェクトファイルをダウンロードします。

## ステップ 2: アプリケーションを設定する
<a name="sql-transform-configure"></a>

埋め込み SQL コードを変換するには、Java プロジェクトに少なくとも 1 つの `.java` ファイルが含まれている必要があります。

JetBrains IDE を使用している場合は、プロジェクト構造の設定で、SDK フィールドを該当する JDK に設定する必要があります。プロジェクト構造の設定については、JetBrains のドキュメントの「[Project structure settings](https://www.jetbrains.com/help/idea/project-settings-and-structure.html)」を参照してください。

## ステップ 3: 埋め込み SQL を変換する
<a name="convert-sql"></a>

Java アプリケーションの埋め込み SQL コードを PostgreSQL ターゲットデータベースに対応する形式に変換するには、次の手順を実行します。

1. Amazon Q がインストールされている IDE で、変換する埋め込み SQLが含まれている Java コードベースを開きます。

1. Amazon Q アイコンをクリックして、チャットパネルを開きます。

1. チャットパネルでアプリケーションを変換するように Amazon Q に依頼します。

1. Java アプリケーションが SQL 変換の条件を満たしている場合、実行する変換の種類を選択するように求められます。**SQL conversion** と入力します。

1. Amazon S3 から取得したスキーマメタデータファイルをアップロードするように求められます。ファイルを取得する手順がチャットで示されます。

1. 埋め込み SQL が含まれるプロジェクトとデータベーススキーマファイルを指定するように求められます。チャットパネルのドロップダウンメニューから適切なファイルを選択します。

1. データベーススキーマから Amazon Q が取得した詳細が正確であることを確認します。

1. Amazon Q が SQL コードの変換を開始します。これには数分かかる場合があります。

1. SQL コードを変換した後、ファイルに加えられた更新が差分として提示されます。差分に示された変更を確認し、変更を受け入れてコードを更新します。

   Amazon Q では、変更の詳細を示す変換の概要も提供されます。

1. コードを更新したら、DMS AWS コンソールに戻り、新しい SQL が移行されたデータベースと互換性があることを確認します。