AWS SCT で、C# アプリケーションの SQL コードを次のように変換します。

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

このような詳細な分析により、C# アプリケーション SQL コードコンバータの方が、汎用コンバータよりも優れた変換結果が得られます。

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

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

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

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

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

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

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

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

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

   

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

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

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

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

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

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

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

SQL コードを変換するには

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

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

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

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

   

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

5. [概要] タブを表示します。

   以下に示す [概要] タブには、C# アプリケーション評価レポートのエグゼクティブサマリーが表示されます。すべての SQL 実行ポイントとすべてのソースコードファイルの変換結果が表示されます。

   

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

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

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

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

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

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