を使用した C# アプリケーションでの SQL コードの変換 AWS Schema Conversion Tool

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

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

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

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

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

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

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

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

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

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

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

   

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

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

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

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

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

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

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

SQL コードを変換するには

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

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

3. Convert. AWS SCT analyzes your source code files を選択し、アプリケーションロジックを決定して、コードメタデータをプロジェクトにロードします。このコードメタデータには、C# クラス、オブジェクト、メソッド、グローバル変数、インターフェイスなどが含まれます。

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

   

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

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

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

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

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

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

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

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

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

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

複数の 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] を選択します。

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

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

以下の手順を使用して、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 コードの変換に必要な推定手作業の複雑さが含まれています。