

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

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

エンジン間でデータベーススキーマを変換するときは、古いデータベースエンジンの代わりに新しいデータベースエンジンとやり取りするように、アプリケーションの SQL コードを更新する必要があります。変換された SQL コードは表示、分析、編集、保存できます。

 AWS Schema Conversion Tool (AWS SCT) を使用して、C\$1\$1、C\$1、Java、またはその他のアプリケーションコードの SQL コードを変換できます。Oracle から PostgreSQL への変換では、 AWS SCT を使用して SQL\$1Plus コードを PSQL に変換できます。また、Oracle から PostgreSQL への変換では、 AWS SCT を使用して C\$1、C\$1\$1、Java、および Pro\$1C アプリケーションに埋め込まれた SQL コードを変換できます。

**Topics**
+ [

## アプリケーション SQL の変換の概要
](#CHAP_Converting.App.Overview)
+ [

# を使用したアプリケーションの SQL コードの変換 AWS SCT
](CHAP_Converting.App.Generic.md)
+ [

# を使用した C\$1 アプリケーションの SQL コードの変換 AWS Schema Conversion Tool
](CHAP_Converting.App.Csharp.md)
+ [

# を使用した C\$1\$1 アプリケーションの SQL コードの変換 AWS Schema Conversion Tool
](CHAP_Converting.App.Cplusplus.md)
+ [

# を使用した Java アプリケーションの SQL コードの変換 AWS Schema Conversion Tool
](CHAP_Converting.App.Java.md)
+ [

# を使用した Pro\$1C アプリケーションの SQL コードの変換 AWS Schema Conversion Tool
](CHAP_Converting.App.ProC.md)

## アプリケーション SQL の変換の概要
<a name="CHAP_Converting.App.Overview"></a>

アプリケーションの SQL コードを変換するには、以下に概説している手順を実行します。
+ [**アプリケーション変換プロジェクトを作成する**] - アプリケーション変換プロジェクトはデータベーススキーマ変換プロジェクトの子になります。データベーススキーマ変換プロジェクトごとに、1 つ以上のアプリケーション変換プロジェクトをその子として作成できます。詳細については、「[での汎用アプリケーション変換プロジェクトの作成 AWS SCT](CHAP_Converting.App.Generic.md#CHAP_Converting.App.Project)」を参照してください。
+ [**SQL コードを分析して変換する**] - AWS SCT でアプリケーションを分析し、SQL コードを抽出して、変換された SQL のローカルバージョンを作成して、確認と編集に使用します。このツールでは、アプリケーションのコードは変換準備ができるまでは変更されません。詳細については、「[での SQL コードの分析と変換 AWS SCT](CHAP_Converting.App.Generic.md#CHAP_Converting.App.Convert)」を参照してください。
+ [**Create an application assessment report**] (アプリケーション評価レポートを作成する) - アプリケーション評価レポートでは、ソースデータベーススキーマからターゲットデータベーススキーマへのアプリケーションの SQL コードの変換について重要な情報を得られます。詳細については、「[で AWS SCT の評価レポートの作成と使用 AWS SCT](CHAP_Converting.App.Generic.md#CHAP_Converting.App.AssessmentReport)」を参照してください。
+ [**Edit, apply changes to, and save your converted SQL code**] (変換された SQL コードを編集、変更適用、保存する) - 評価レポートには、自動変換できない SQL コード項目のリストが含まれます。これらの項目の変換を実行するように、SQL コードを手動で編集できます。詳細については、「[で変換した SQL コードを編集して保存する AWS SCT](CHAP_Converting.App.Generic.md#CHAP_Converting.App.Edit)」を参照してください。

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

を使用して AWS SCT 、アプリケーションに埋め込まれた SQL コードを変換できます。汎用 AWS SCT アプリケーションコンバータは、アプリケーションコードをプレーンテキストとして扱います。アプリケーションコードをスキャンし、正規表現を使用して SQL コードを抽出します。このコンバータは、さまざまなタイプのソースコードファイルをサポートし、あらゆるプログラミング言語で記述されたアプリケーションコードで動作します。

汎用アプリケーションコンバータには次の制約事項があります。アプリケーションのプログラミング言語に固有のアプリケーションロジックを深く掘り下げることはありません。また、汎用コンバータは、関数、パラメータ、ローカル変数など、さまざまなアプリケーションオブジェクトの SQL ステートメントをサポートしていません。

アプリケーションの SQL コード変換を改善するには、言語固有のアプリケーション SQL コードコンバータを使用してください。詳細については、[C\$1 アプリケーションでの SQL コード](CHAP_Converting.App.Csharp.md)、[Java の SQL コード](CHAP_Converting.App.Java.md)、および [Pro\$1C の SQL コード](CHAP_Converting.App.ProC.md) を参照してください。

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

では AWS Schema Conversion Tool、アプリケーション変換プロジェクトはデータベーススキーマ変換プロジェクトの子です。データベーススキーマ変換プロジェクトごとに、1 つ以上のアプリケーション変換プロジェクトをその子として作成できます。

**注記**  
AWS SCT は、次のソースとターゲット間の変換をサポートしていません。  
Oracle から Oracle へ
PostgreSQL から PostgreSQL または Aurora PostgreSQL へ
MySQL から MySQL へ
SQL サーバーから SQL サーバーへ
Amazon Redshift から Amazon Redshift へ
SQL サーバーから Babelfish へ
への SQL Server 統合サービス AWS Glue
Apache Cassandra から Amazon DynamoDB へ

 以下の手順を使用して、汎用アプリケーション変換プロジェクトを作成します。

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

1. で AWS Schema Conversion Tool、**アプリケーションメニューで新しい汎用****アプリケーション**を選択します。

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

1. 以下のプロジェクト情報を追加します。  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/SchemaConversionTool/latest/userguide/CHAP_Converting.App.Generic.html)

1. バインド変数型が SQL 型に変換されないようにするには、[**バインド変数型を SQL 型にキャストしない**] を選択します。このオプションは、Oracle から PostgreSQL に変換する場合にのみ使用できます。

   たとえば、ソースアプリケーションコードに次の Oracle クエリが含まれているとします。

   ```
   SELECT * FROM ACCOUNT WHERE id = ?
   ```

   [**バインド変数を SQL 型にキャストしない**] を選択すると、 AWS SCT はこのクエリを以下のように変換します。

   ```
   SELECT * FROM account WHERE id = ?
   ```

   [**バインド変数を SQL 型にキャストしない**] をオフに すると、 AWS SCT はバインド変数の型を `NUMERIC` データ型に変更します。変換結果は次のように表示されます。

   ```
   SELECT * FROM account WHERE id = (?)::NUMERIC
   ```

1. 変換されたオブジェクトの名前にスキーマ名が追加されないようにするには、[**オブジェクト名を保存**] を選択します。このオプションは、Oracle から PostgreSQL に変換する場合にのみ使用できます。

   たとえば、ソースアプリケーションコードに次の Oracle クエリが含まれているとします。

   ```
   SELECT * FROM ACCOUNT
   ```

   [**オブジェクト名を保存**] を選択すると、 AWS SCT はこのクエリを以下のように変換します。

   ```
   SELECT * FROM account
   ```

   [**オブジェクト名を保存**] をオフにすると、 AWS SCT はテーブル名にスキーマ名を追加します。変換結果は次のように表示されます。

   ```
   SELECT * FROM schema_name.account
   ```

   ソースコードに親オブジェクトの名前がオブジェクトの名前に含まれている場合、 は変換されたコードでこの形式 AWS SCT を使用します。この場合、[**オブジェクト名を保存**] オプションは無視してください。 AWS SCT では、変換後のコードには親オブジェクトの名前が追加されるからです。

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

   プロジェクトウィンドウが開きます。  
![\[プロジェクトウィンドウ\]](http://docs.aws.amazon.com/ja_jp/SchemaConversionTool/latest/userguide/images/applications-project-window.png)

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

既存のアプリケーション変換プロジェクトを開いて、複数のアプリケーション変換プロジェクトを追加できます。

アプリケーション変換プロジェクトを初めて作成すると、プロジェクトウィンドウが自動的に開きます。アプリケーション変換プロジェクトウィンドウを閉じて、後で戻ることができます。

**既存のアプリケーション変換プロジェクトを開くには**

1. 左側のパネルでアプリケーション変換プロジェクトノードを選択し、コンテキスト (右クリック) メニューを開き、コンテキスト (右クリック) メニューを開きます。

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

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

1. 左側のパネルでアプリケーション変換プロジェクトノードを選択し、コンテキスト (右クリック) メニューを開き、コンテキスト (右クリック) メニューを開きます。

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

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

## での SQL コードの分析と変換 AWS SCT
<a name="CHAP_Converting.App.Convert"></a>

以下の手順で、 AWS Schema Conversion Toolで SQL コードを分析して変換します。

**SQL コードを変換して分析するには**

1. 既存のアプリケーション変換プロジェクトを開き、[**分析**] を選択します。

   AWS SCT はアプリケーションコードを分析し、SQL コードを抽出します。 は、抽出された SQL コードを**解析された SQL スクリプト**リストに AWS SCT 表示します。

1. **解析された SQL スクリプト**の場合、項目を選択して抽出された SQL コードを確認します。 は、抽出**された SQL スクリプト**ペインに選択した項目のコード AWS SCT を表示します。

1. **変換** を選択して、**抽出された SQL スクリプトペインの SQL** コードを変換します。 は、コードをターゲットデータベースと互換性のある形式 AWS SCT に変換します。

   変換された SQL コードは編集できます。詳細については、「[変換された SQL コードの編集と保存](#CHAP_Converting.App.Edit)」を参照してください。  
![\[分析する SQL コード\]](http://docs.aws.amazon.com/ja_jp/SchemaConversionTool/latest/userguide/images/applications-project-analyze.png)

1. アプリケーション変換評価レポートを作成すると、 は抽出されたすべての SQL コード項目を AWS SCT 変換します。詳細については、「[評価レポートの作成と使用](#CHAP_Converting.App.AssessmentReport)」を参照してください。

## で AWS SCT の評価レポートの作成と使用 AWS SCT
<a name="CHAP_Converting.App.AssessmentReport"></a>

*アプリケーション変換評価レポート*には、アプリケーションの SQL コードをターゲットデータベースと互換性のある形式に変換する方法についての情報が記載されています。レポートには、抽出されたすべての SQL コード、変換されたすべての SQL コード、および変換できない SQL AWS SCT コードのアクション項目の詳細が表示されます。

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

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

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

1. アプリケーション変換プロジェクトウィンドウで、[**アクション**] メニューから [**レポートを作成**] を選択します。

   AWS SCT はアプリケーション変換評価レポートを作成し、アプリケーション変換プロジェクトウィンドウで開きます。

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

   以下に示している [**概要**] タブには、アプリケーション評価レポートの要約が表示されます。そのタブには、自動変換されなかった SQL コード項目と自動変換された SQL コード項目が示されます。  
![\[アプリケーション評価レポートの [概要] タブ\]](http://docs.aws.amazon.com/ja_jp/SchemaConversionTool/latest/userguide/images/applications-summary.png)

1. [**SQL 抽出アクション**] を選択します。

   ソースコードから抽出できない SQL AWS SCT コード項目のリストを確認します。

1. [**SQL 変換アクション**] を選択します。

   が自動的に変換できない SQL AWS SCT コード項目のリストを確認します。推奨アクションを使用して SQL コードを手動で変換します。変換された SQL コードを編集する方法については、「[で変換した SQL コードを編集して保存する AWS SCT](#CHAP_Converting.App.Edit)」を参照してください。

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

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

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

## で変換した SQL コードを編集して保存する AWS SCT
<a name="CHAP_Converting.App.Edit"></a>

評価レポートには、変換できない SQL AWS SCT コード項目のリストが含まれます。各項目について、 は **SQL 変換アクションタブにアクション**項目 AWS SCT を作成します。これらの項目の変換を実行するように、SQL コードを手動で編集できます。

以下の手順を使用して、変換された SQL コードを編集、変更適用、保存します。

**変換された SQL コードを編集、変更適用、保存するには**

1. [**Target SQL script**] (ターゲット SQL スクリプト) ペインで直接、変換された SQL コードを編集します。変換されたコードが表示されていない場合は、ペイン内をクリックすると、入力を開始できます。

1. 変換された SQL コードの編集が終了したら、[**適用**] を選択します。この時点で、変更はメモリに保存されますが、まだファイルには書き込まれていません。

1. [**保存**] を選択すると、変更がファイルに保存されます。

   [**保存**] を選択すると、元のファイルが上書きされます。保存前に、元のアプリケーションコードの記録用に元のファイルのコピーを作成します。

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

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

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

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

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

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

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

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. [**アプリケーション**] メニューから [**新しい C\$1 アプリケーション**] を選択します。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   以下に示す [**概要**] タブには、C\$1 アプリケーション評価レポートのエグゼクティブサマリーが表示されます。すべての SQL 実行ポイントとすべてのソースコードファイルの変換結果が表示されます。  
![\[C# アプリケーション評価レポートの [概要] タブ\]](http://docs.aws.amazon.com/ja_jp/SchemaConversionTool/latest/userguide/images/csharp-applications-summary.png)

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

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

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

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

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

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

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

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

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

1 つの AWS SCT プロジェクトに複数のアプリケーション変換プロジェクトを追加できます。

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

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. [**アプリケーション**] メニュー で、[**新しい C\$1\$1 アプリケーション**] を選択します。

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

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

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

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

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

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

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

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

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

1. 左パネルの [**アプリケーション**] の下の [**C\$1\$1**] ノードを展開し、変換するアプリケーションを選択します。

1. **ソース Oracle アプリケーションプロジェクト**で、[**設定**] を選択します。選択した C\$1\$1 アプリケーションの変換設定を確認して編集します。 AWS SCT プロジェクトに追加したすべての C\$1\$1 アプリケーションの変換設定を指定することもできます。詳細については、「[C\$1\$1 アプリケーション変換プロジェクトの管理](#CHAP_Converting.App.Cplusplus.Manage)」を参照してください。

1. **Compiler タイプ**では、C\$1\$1 アプリケーションのソースコードに使用するコンパイラを選択します。 は**、Microsoft Visual C\$1\$1**、**GCC、GNU Compiler Collection**、および **Clang** の C\$1\$1 コンパイラ AWS SCT をサポートしています。デフォルトオプションは [**Microsoft Visual C\$1\$1**] です。

1. **ユーザー定義マクロ**の場合は、C\$1\$1 プロジェクトのユーザー定義マクロを含むファイルへのパスを入力します。このファイルの構造が、`#define name value` であることを確認します。前の例では、`value` はオプションのパラメータです。このオプションのパラメータのデフォルト値は `1` です。

   このファイルを作成するには、Microsoft Visual Studio でプロジェクトを開き、[**プロジェクト**]、[**プロパティ**]、[**C/C\$1\$1**]、および [**プリプロセッサ**] を選択します。**プリプロセッサ定義**の場合は、[**編集]** を選択し、名前と値を新しいテキストファイルにコピーします。次に、ファイル内の各文字列に、プレフィックス `#define ` を追加します。

1. **外部インクルードディレクトリ**には、C\$1\$1 プロジェクトで使用する外部ライブラリを含むフォルダへのパスを入力します。

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

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

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

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

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

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

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

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

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

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

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

複数の C\$1\$1 アプリケーション変換プロジェクトの追加、変換設定の編集、C\$1\$1 アプリケーションコードの更新、プロジェクトからの C\$1\$1 変換プロジェクトの削除を行うことができます AWS SCT 。

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

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

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

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

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

 AWS SCT プロジェクト内のすべての C\$1\$1 アプリケーション変換プロジェクトの変換設定を指定できます。

**すべての C\$1\$1 アプリケーションの変換設定を編集するには**

1. [**設定**] メニューで [**プロジェクト設定]** を選択し、[**アプリケーション変換**] を選択します。

1. **Compiler タイプ**では、C\$1\$1 アプリケーションのソースコードに使用するコンパイラを選択します。 は**、Microsoft Visual C\$1\$1、GCC、GNU Compiler Collection、および Clang の C**\$1\$1 コンパイラ AWS SCT をサポートしています。 **** ** **デフォルトオプションは [**Microsoft Visual C\$1\$1**] です。

1. **ユーザー定義マクロ**の場合は、C\$1\$1 プロジェクトのユーザー定義マクロを含むファイルへのパスを入力します。このファイルの構造が、`#define name value` であることを確認します。前の例では、`value` はオプションのパラメータです。このオプションのパラメータのデフォルト値は `1` です。

   このファイルを作成するには、Microsoft Visual Studio でプロジェクトを開き、[**プロジェクト**]、[**プロパティ**]、[**C/C\$1\$1**]、および [**プリプロセッサ**] を選択します。**プリプロセッサ定義**の場合は、[**編集]** を選択し、名前と値を新しいテキストファイルにコピーします。次に、ファイル内の各文字列に、プレフィックス `#define ` を追加します。

1. **外部インクルードディレクトリ**には、C\$1\$1 プロジェクトで使用する外部ライブラリを含むフォルダへのパスを入力します。

1. [**OK**] を選択してプロジェクト設定を保存し、ウィンドウを閉じます。

または、C\$1\$1 アプリケーション変換プロジェクトごとに変換設定を指定することもできます。詳細については、「[C\$1\$1 アプリケーションの SQL コードの変換](#CHAP_Converting.App.Cplusplus.Convert)」を参照してください。

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

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

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

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

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

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

   また、選択したアプリケーションに指定したアプリケーション変換設定も AWS SCT 削除されます。更新されたアプリケーションコードをアップロードすると、 はプロジェクト設定のデフォルト値 AWS SCT を適用します。

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

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

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

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

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

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

**C\$1\$1 アプリケーション変換評価レポートを作成するには**

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

**Pro\$1C アプリケーション変換プロジェクトを作成するには**

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. [**アプリケーション**] メニューで [**新しい Pro\$1C アプリケーション**] を選択します。

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

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

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

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

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

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

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

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

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

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

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

   1. [**グローバルヘッダーファイルパス**] には、アプリケーションプロジェクトが使用するヘッダーファイルへのパスを入力します。

   1. [**未解決のホスト変数をすべて解釈する**] を選択すると、変換されたコード内の未解決変数がすべて表示されます。

   1. 変換された SQL コードで拡張パック関数を使用するには、拡張パックの [**固定幅文字列変換関数を使用**] を選択します。 AWS SCT は、拡張パックファイルをアプリケーションプロジェクトに含めます。

   1. **匿名 PL/SQL ブロックをスタンドアロン SQL 呼び出しまたはストアド関数**に変換して、すべての匿名 PL/SQL ブロックのターゲットデータベースにストアドプロシージャを作成します。 AWS SCT は、変換されたアプリケーションコードにこれらのストアドプロシージャの実行を含めます。

   1. Oracle データベースカーソルの変換を改善するには、[**カスタムカーソルフローを使用**] を選択します。

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

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

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

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

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

変換された SQL ステートメントを編集し AWS SCT 、 を使用して、この編集されたコードを変換された Pro\$1C アプリケーションコードに埋め込むことができます。次の手順に従って、変換された SQL コードを編集します。

**変換された SQL コードを編集するには**

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

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

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

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

1. 抽出した SQL コードを保存する CSV ファイルの名前を入力し、[**保存**] を選択します。

1. 抽出した SQL コードを編集します。

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

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

1. 変換したアプリケーションを選択し、コンテキスト (右クリック) メニューを開き、[**CSV からステートメントをインポート**] を選択します。

1. [**はい**] を選択し、編集した SQL コードを含むファイルを選択して [**開く**] を選択します。

AWS SCT は、変換された SQL ステートメントをパートに分割し、ソースアプリケーションコードの適切なオブジェクトに配置します。次の手順に従って、変換されたアプリケーションコードを保存します。

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

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

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

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

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

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

**Pro\$1C アプリケーション変換プロジェクトを追加するには**

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

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

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

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

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

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

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

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

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

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

**Pro\$1C アプリケーション変換プロジェクトを削除するには**

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

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

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

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

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

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

**Pro\$1C アプリケーション変換評価レポートを作成するには:**

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

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

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

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

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

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

1. Pro\$1C アプリケーションから抽出した SQL コードを、カンマ区切り値 (CSV) ファイルとして保存するには、[**ステートメントを CSV に保存**] を選択します。

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

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

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