

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 轉換應用程式 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 將內嵌的 SQL 程式碼轉換為 C\$1、C\$1\$1、Java 和 Pro\$1C 應用程式。

**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 程式碼，請採取下列高階步驟：
+ **建立應用程式轉換專案** – 應用程式轉換專案是資料庫結構描述轉換專案的子項。每個資料庫結構描述轉換專案可以有一或多個子項應用程式轉換專案。如需詳細資訊，請參閱[在 中建立一般應用程式轉換專案 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)。
+ **建立應用程式評估報告** – 應用程式評估報告提供有關將應用程式 SQL 程式碼從來源資料庫結構描述轉換為目標資料庫結構描述的重要資訊。如需詳細資訊，請參閱[在 中建立和使用 AWS SCT 評估報告 AWS SCT](CHAP_Converting.App.Generic.md#CHAP_Converting.App.AssessmentReport)。
+ **編輯、套用變更並儲存轉換後的 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，應用程式轉換專案是資料庫結構描述轉換專案的子項。每個資料庫結構描述轉換專案可以有一或多個子項應用程式轉換專案。

**注意**  
AWS SCT 不支援下列來源和目標之間的轉換：  
Oracle 到 Oracle
PostgreSQL 到 PostgreSQL 或 Aurora PostgreSQL
MySQL 到 MySQL
SQL Server 到 SQL Server
Amazon Redshift 到 Amazon Redshift
SQL Server 到 Babelfish
的 SQL Server 整合服務 AWS Glue
Apache Cassandra 到 Amazon DynamoDB

 使用下列程序來建立一般應用程式轉換專案。

**若要建立應用程式轉換專案**

1. 在 中 AWS Schema Conversion Tool，選擇**應用程式功能表上的新增一般****應用程式**。

   會出現 **New application conversion project** (新增應用程式轉換專案) 對話方塊。  
![\[New application conversion project (新增應用程式轉換專案) 對話方塊\]](http://docs.aws.amazon.com/zh_tw/SchemaConversionTool/latest/userguide/images/applications-new-project.png)

1. 新增下列專案資訊。  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/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/zh_tw/SchemaConversionTool/latest/userguide/images/applications-project-window.png)

## 在 中管理應用程式轉換專案 AWS SCT
<a name="CHAP_Converting.App.Manage"></a>

您可以開啟現有的應用程式轉換專案，並新增多個應用程式轉換專案。

建立應用程式轉換專案後，專案視窗會自動開啟。您可以關閉應用程式轉換專案視窗，稍後再返回。

**開啟現有的應用程式轉換專案**

1. 在左側面板中，選擇應用程式轉換專案節點，然後開啟內容 （按一下滑鼠右鍵） 選單。

1. 選擇**管理應用程式**。

**新增額外的應用程式轉換專案**

1. 在左側面板中，選擇應用程式轉換專案節點，然後開啟內容 （按一下滑鼠右鍵） 選單。

1. 選擇 **New application** (新增應用程式)。

1. 輸入建立新應用程式轉換專案所需的資訊。如需詳細資訊，請參閱[建立一般應用程式轉換專案](#CHAP_Converting.App.Project)。

## 在 中分析和轉換 SQL 程式碼 AWS SCT
<a name="CHAP_Converting.App.Convert"></a>

使用下列程序來分析和轉換 中的 SQL 程式碼 AWS Schema Conversion Tool。

**若要分析和轉換您的 SQL 程式碼**

1. 開啟現有的應用程式轉換專案，然後選擇**分析**。

   AWS SCT 會分析您的應用程式程式碼並擷取 SQL 程式碼。 會在剖析的 SQL 指令碼清單中 AWS SCT 顯示擷取的 SQL 程式碼。 ****

1. 對於**剖析的 SQL 指令碼**，請選擇項目以檢閱其擷取的 SQL 程式碼。在**擷取的 SQL 指令碼**窗格中 AWS SCT 顯示所選項目的程式碼。

1. 選擇**轉換**以將 SQL 程式碼轉換為**擷取的 SQL 指令碼**窗格。 會將程式碼 AWS SCT 轉換為與您的目標資料庫相容的格式。

   您可以編輯轉換後的 SQL 程式碼。如需詳細資訊，請參閱[編輯和儲存轉換後的 SQL 程式碼](#CHAP_Converting.App.Edit)。  
![\[要分析的 SQL 程式碼\]](http://docs.aws.amazon.com/zh_tw/SchemaConversionTool/latest/userguide/images/applications-project-analyze.png)

1. 當您建立應用程式轉換評估報告時， 會 AWS SCT 轉換所有擷取的 SQL 程式碼項目。如需詳細資訊，請參閱[建立和使用評估報告](#CHAP_Converting.App.AssessmentReport)。

## 在 中建立和使用 AWS SCT 評估報告 AWS SCT
<a name="CHAP_Converting.App.AssessmentReport"></a>

*應用程式轉換評估報告*提供有關將應用程式 SQL 程式碼轉換為與您目標資料庫相容格式的資訊。報告會詳細說明所有擷取的 SQL 程式碼、所有轉換後的 SQL 程式碼，以及 AWS SCT 無法轉換之 SQL 程式碼的動作項目。

### 建立應用程式轉換評估報告
<a name="CHAP_Converting.App.AssessmentReport.Create"></a>

使用下列程序來建立應用程式轉換評估報告。

**建立應用程式轉換評估報告**

1. 在應用程式轉換專案視窗中，選擇**動作**功能表上的**建立報告**。

   AWS SCT 會建立應用程式轉換評估報告，並在應用程式轉換專案視窗中開啟報告。

1. 檢閱 **Summary** (摘要) 索引標籤。

   摘要****索引標籤如下所示，顯示應用程式評估報告中的摘要資訊。它會顯示已自動轉換的 SQL 程式碼項目，以及無法自動轉換的項目。  
![\[應用程式評估報告 Summary (摘要) 索引標籤\]](http://docs.aws.amazon.com/zh_tw/SchemaConversionTool/latest/userguide/images/applications-summary.png)

1. 選擇 **SQL 擷取動作**。

   檢閱 AWS SCT 無法從原始程式碼擷取的 SQL 程式碼項目清單。

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>

評估報告包含 AWS SCT 無法轉換的 SQL 程式碼項目清單。對於每個項目， 會在 SQL 轉換動作索引標籤上 AWS SCT 建立動作項目。 ****對於這些項目，您可以手動編輯 SQL 程式碼以執行轉換。

使用下列步驟來編輯您的轉換後 SQL 程式碼、套用變更，然後儲存。

**若要編輯、套用變更，並儲存轉換後的 SQL 程式碼**

1. 直接在 **Target SQL script** (目標 SQL 指令碼) 窗格中編輯轉換後 SQL 程式碼。如果未顯示轉換後的程式碼，您可以在窗格中按一下，並開始輸入。

1. 當您完成編輯轉換後的 SQL 程式碼，請選擇 **Apply** (套用)。此時，變更就會儲存在記憶體中，但尚未寫入您的檔案。

1. 選擇 **Save** (儲存) 將變更儲存至您的檔案。

   選擇**儲存**時，您會覆寫原始檔案。在儲存前先複製您的原始檔案，即可擁有一份原始應用程式程式碼的記錄。

# 使用 轉換 C\$1 應用程式中的 SQL 程式碼 AWS Schema Conversion Tool
<a name="CHAP_Converting.App.Csharp"></a>

對於 Oracle 轉換為 PostgreSQL，您可以使用 AWS Schema Conversion Tool (AWS SCT) 將內嵌的 SQL 程式碼轉換為 C\$1 應用程式。這個特定的 C\$1 應用程式轉換器了解應用程式邏輯。它會收集位於不同應用程式物件中的陳述式，例如函數、參數、本機變數等。

由於此深度分析，C\$1 應用程式 SQL 程式碼轉換器提供比一般轉換器更好的轉換結果。

## 在 中建立 C\$1 應用程式轉換專案 AWS SCT
<a name="CHAP_Converting.App.Csharp.Create"></a>

您只能建立將 Oracle 資料庫結構描述轉換為 PostgreSQL 資料庫結構描述的 C\$1 應用程式轉換專案。請務必在專案中新增映射規則，其中包含來源 Oracle 結構描述和目標 PostgreSQL 資料庫。如需詳細資訊，請參閱[中的映射資料類型 AWS Schema Conversion Tool](CHAP_Mapping.md)。

您可以在單一專案中新增多個應用程式轉換 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\$1 應用程式轉換專案**對話方塊。  
![\[新的 C# 應用程式轉換專案對話方塊\]](http://docs.aws.amazon.com/zh_tw/SchemaConversionTool/latest/userguide/images/csharp-application-new-project.png)

1. 在**名稱**中，輸入 C\$1 應用程式轉換專案的名稱。由於每個資料庫結構描述轉換專案可以有一或多個子應用程式轉換專案，因此如果您新增多個專案，請選擇有意義的名稱。

1. 針對**位置**，輸入應用程式的來源碼位置。

1. 在來源樹狀目錄中，選擇應用程式使用的結構描述。請確定此結構描述是映射規則的一部分。 會以粗體 AWS SCT 強調映射規則一部分的結構描述。

1. 選擇**確定**以建立 C\$1 應用程式轉換專案。

1. 在左側面板的應用程式節點中尋找您的 C\$1 **應用程式**轉換專案。

## 在 中轉換 C\$1 應用程式 SQL 程式碼 AWS SCT
<a name="CHAP_Converting.App.Csharp.Convert"></a>

將 C\$1 應用程式新增至 AWS SCT 專案後，請將此應用程式中的 SQL 程式碼轉換為與您的目標資料庫平台相容的格式。使用下列程序來分析和轉換內嵌在 中 C\$1 應用程式中的 SQL 程式碼 AWS Schema Conversion Tool。

**轉換 SQL 程式碼**

1. 在左側面板中的**應用程式**下展開 **C\$1** 節點。

1. 選擇要轉換的應用程式，然後開啟內容 （按一下滑鼠右鍵） 選單。

1.  選擇 **Convert**. AWS SCT analyzes 您的原始程式碼檔案、判斷應用程式邏輯，並將程式碼中繼資料載入專案。此程式碼中繼資料包括 C\$1 類別、物件、方法、全域變數、介面等。

   在目標資料庫面板中， 會 AWS SCT 建立與來源應用程式專案類似的資料夾結構。您可以在這裡檢閱轉換後的應用程式程式碼。  
![\[要分析的 SQL 程式碼\]](http://docs.aws.amazon.com/zh_tw/SchemaConversionTool/latest/userguide/images/csharp-applications-project-analyze.png)

1. 儲存轉換後的應用程式程式碼。如需詳細資訊，請參閱[儲存轉換後的應用程式程式碼](#CHAP_Converting.App.Csharp.Save)。

您的 C\$1 應用程式可能包含與不同來源資料庫互動的 SQL 程式碼。您可以遷移至 PostgreSQL 其中數個來源資料庫。在此情況下，請確定您不會轉換與從遷移範圍排除的資料庫互動的 SQL 程式碼。您可以從轉換範圍中排除 C\$1 應用程式的來源檔案。若要這麼做，請清除您要從轉換範圍中排除之檔案名稱的核取方塊。

變更轉換範圍之後， AWS SCT 仍然會分析 SQL 程式碼 C\$1 應用程式的所有來源檔案。然後，將您在轉換範圍中排除的所有來源檔案 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. 選擇 **New application** (新增應用程式)。

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. 選擇**刪除**，然後選擇**確定**。

## 在 中建立 C\$1 應用程式轉換評估報告 AWS SCT
<a name="CHAP_Converting.App.Csharp.AssessmentReport"></a>

*C\$1 應用程式轉換評估報告*提供有關將 C\$1 應用程式中內嵌的 SQL 程式碼轉換為與目標資料庫相容格式的資訊。評估報告提供所有 SQL 執行點和所有原始程式碼檔案的轉換詳細資訊。評估報告也包含 AWS SCT 無法轉換之 SQL 程式碼的動作項目。

使用下列程序建立 C\$1 應用程式轉換評估報告。

**建立 C\$1 應用程式轉換評估報告**

1. 在左側面板中的**應用程式**下方展開 **C\$1** 節點。

1. 選擇要轉換的應用程式，然後開啟內容 （按一下滑鼠右鍵） 選單。

1. 選擇**轉換**。

1. 在**檢視**功能表中，選擇**評估報告檢視**。

1. 檢視**摘要**索引標籤。

   摘要****索引標籤如下所示，顯示來自 C\$1 應用程式評估報告的執行摘要資訊。它會顯示所有 SQL 執行點和所有原始程式碼檔案的轉換結果。  
![\[C# 應用程式評估報告摘要索引標籤\]](http://docs.aws.amazon.com/zh_tw/SchemaConversionTool/latest/userguide/images/csharp-applications-summary.png)

1. 選擇將**陳述式儲存至 JSON**，將從您的 C\$1 應用程式擷取的 SQL 程式碼儲存為 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 將內嵌的 SQL 程式碼轉換為 C\$1\$1 應用程式。這個特定的 C\$1\$1 應用程式轉換器了解應用程式邏輯。它會收集位於不同應用程式物件中的陳述式，例如函數、參數、本機變數等。

由於此深度分析，C\$1\$1 應用程式 SQL 程式碼轉換器提供比一般轉換器更好的轉換結果。

## 在 中建立 C\$1\$1 應用程式轉換專案 AWS SCT
<a name="CHAP_Converting.App.Cplusplus.Create"></a>

您只能建立將 Oracle 資料庫結構描述轉換為 PostgreSQL 資料庫結構描述的 C\$1\$1 應用程式轉換專案。請務必在專案中新增映射規則，其中包含來源 Oracle 結構描述和目標 PostgreSQL 資料庫。如需詳細資訊，請參閱[中的映射資料類型 AWS Schema Conversion Tool](CHAP_Mapping.md)。

您可以在單一 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 應用程式轉換專案**對話方塊。  
![\[新的 C++ 應用程式轉換專案對話方塊\]](http://docs.aws.amazon.com/zh_tw/SchemaConversionTool/latest/userguide/images/cplusplus-application-new-project.png)

1. 在**名稱**中，輸入 C\$1\$1 應用程式轉換專案的名稱。由於每個資料庫結構描述轉換專案可以有一或多個子應用程式轉換專案，因此如果您新增多個專案，請選擇有意義的名稱。

1. 針對**位置**，輸入應用程式的來源碼位置。

1. 在來源樹狀目錄中，選擇應用程式使用的結構描述。請確定此結構描述是映射規則的一部分。 會以粗體 AWS SCT 強調映射規則一部分的結構描述。

1. 選擇**確定**以建立 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 程式碼轉換為與您的目標資料庫平台相容的格式。使用下列程序來分析和轉換內嵌於 C\$1\$1 應用程式的 SQL 程式碼 AWS SCT。

**轉換 SQL 程式碼**

1. 在左側面板中的**應用程式**下展開 **C\$1\$1** 節點，然後選擇要轉換的應用程式。

1. 在**來源 Oracle 應用程式專案**中，選擇**設定**。檢閱和編輯所選 C\$1\$1 應用程式的轉換設定。您也可以為您新增至 AWS SCT 專案的所有 C\$1\$1 應用程式指定轉換設定。如需詳細資訊，請參閱[管理 C\$1\$1 應用程式轉換專案](#CHAP_Converting.App.Cplusplus.Manage)。

1. 針對**編譯器類型**，選擇您用於 C\$1\$1 應用程式的原始程式碼的編譯器。 AWS SCT 支援下列 C\$1\$1 編譯器：**Microsoft Visual C\$1\$1**、**GCC、GNU 編譯器集合**和 **Clang**。預設選項為 **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 您的原始程式碼檔案、判斷應用程式邏輯，並將程式碼中繼資料載入專案。此程式碼中繼資料包括 C\$1\$1 類別、物件、方法、全域變數、介面等。

   在目標資料庫面板中， 會 AWS SCT 建立與來源應用程式專案類似的資料夾結構。您可以在這裡檢閱轉換後的應用程式程式碼，如下所示。  
![\[要分析的 SQL 程式碼\]](http://docs.aws.amazon.com/zh_tw/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 應用程式程式碼，或從 AWS SCT 專案中移除 C\$1\$1 轉換專案。

**新增額外的 C\$1\$1 應用程式轉換專案**

1. 展開左側面板中的**應用程式**節點。

1. 選擇 **C\$1\$1** 節點，然後開啟內容 （按一下滑鼠右鍵） 選單。

1. 選擇 **New application** (新增應用程式)。

1. 輸入建立新 C\$1\$1 應用程式轉換專案所需的資訊。如需詳細資訊，請參閱[建立 C\$1\$1 應用程式轉換專案](#CHAP_Converting.App.Cplusplus.Create)。

您可以為 AWS SCT 專案中的所有 C\$1\$1 應用程式轉換專案指定轉換設定。

**編輯所有 C\$1\$1 應用程式的轉換設定**

1. 在**設定**功能表中，選擇**專案設定**，然後選擇**應用程式轉換**。

1. 針對**編譯器類型**，選擇您用於 C\$1\$1 應用程式的原始程式碼的編譯器。 AWS SCT 支援下列 C\$1\$1 編譯器：**Microsoft Visual C\$1\$1**、**GCC、GNU 編譯器集合**和 **Clang **。預設選項為 **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. 選擇**確定**以儲存專案設定並關閉視窗。

或者，您可以為每個 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. 選擇**刪除**，然後選擇**確定**。

## 在 中建立 C\$1\$1 應用程式轉換評估報告 AWS SCT
<a name="CHAP_Converting.App.Cplusplus.AssessmentReport"></a>

*C\$1\$1 應用程式轉換評估報告*提供有關將 C\$1\$1 應用程式中內嵌的 SQL 程式碼轉換為與目標資料庫相容格式的資訊。評估報告提供所有 SQL 執行點和所有原始程式碼檔案的轉換詳細資訊。評估報告也包含 AWS SCT 無法轉換之 SQL 程式碼的動作項目。

**建立 C\$1\$1 應用程式轉換評估報告**

1. 在左側面板中的**應用程式**下展開 **C\$1\$1** 節點。

1. 選擇要轉換的應用程式，然後開啟內容 （按一下滑鼠右鍵） 選單。

1. 選擇**轉換**。

1. 在**檢視**功能表上，選擇**評估報告檢視**。

1. 檢視**摘要**索引標籤。

   **摘要**索引標籤會顯示來自 C\$1\$1 應用程式評估報告的執行摘要資訊。它會顯示所有 SQL 執行點和所有原始程式碼檔案的轉換結果。

1. 選擇將**陳述式儲存至 JSON**，將從 Java 應用程式擷取的 SQL 程式碼儲存為 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 將內嵌的 SQL 程式碼轉換為 Java 應用程式。這個特定的 Java 應用程式轉換器了解應用程式邏輯。它會收集位於不同應用程式物件中的陳述式，例如函數、參數、本機變數等。

由於此深度分析，Java 應用程式 SQL 程式碼轉換器提供比一般轉換器更好的轉換結果。

如果您的 Java 應用程式使用 MyBatis 架構與資料庫互動，您可以使用 AWS SCT 來轉換內嵌至 MyBatis XML 檔案和註釋的 SQL 陳述式。若要了解這些 SQL 陳述式的邏輯， AWS SCT 會使用 MyBatis 組態檔案。 AWS SCT 可以在您的應用程式資料夾中自動探索此檔案，或者您可以手動輸入此檔案的路徑。

## 在 中建立 Java 應用程式轉換專案 AWS SCT
<a name="CHAP_Converting.App.Java.Create"></a>

您只能建立將 Oracle 資料庫結構描述轉換為 PostgreSQL 資料庫結構描述的 Java 應用程式轉換專案。請務必在專案中新增映射規則，其中包含來源 Oracle 結構描述和目標 PostgreSQL 資料庫。如需詳細資訊，請參閱[中的映射資料類型 AWS Schema Conversion Tool](CHAP_Mapping.md)。

您可以在單一專案中新增多個應用程式轉換 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 應用程式轉換專案**對話方塊。  
![\[新的 Java 應用程式轉換專案對話方塊\]](http://docs.aws.amazon.com/zh_tw/SchemaConversionTool/latest/userguide/images/java-application-new-project.png)

1. 在**名稱**中，輸入 Java 應用程式轉換專案的名稱。由於每個資料庫結構描述轉換專案可以有一或多個子應用程式轉換專案，因此如果您新增多個專案，請選擇有意義的名稱。

1. 針對**位置**，輸入應用程式的來源碼位置。

1. （選用） 對於 **MyBatis 組態檔案**，輸入 MyBatis 組態檔案的路徑。 會 AWS SCT 掃描您的應用程式資料夾以自動探索此檔案。如果您的應用程式資料夾中沒有此檔案，或者您使用多個組態檔案，請手動輸入路徑。

1. 在來源樹狀目錄中，選擇應用程式使用的結構描述。請確定此結構描述是映射規則的一部分。 會以粗體 AWS SCT 強調映射規則一部分的結構描述。

1. 選擇**確定**以建立您的 Java 應用程式轉換專案。

1. 在左側面板的應用程式節點中尋找您的 Java **應用程式**轉換專案。

## 在 中轉換 Java 應用程式 SQL 程式碼 AWS SCT
<a name="CHAP_Converting.App.Java.Convert"></a>

將 Java 應用程式新增至 AWS SCT 專案後，請將此應用程式中的 SQL 程式碼轉換為與您的目標資料庫平台相容的格式。使用下列程序來分析和轉換 中內嵌於 Java 應用程式的 SQL 程式碼 AWS Schema Conversion Tool。

**轉換 SQL 程式碼**

1. 在左側面板中的**應用程式**下展開 **Java** 節點。

1. 選擇要轉換的應用程式，然後開啟內容 （按一下滑鼠右鍵） 選單。

1.  選擇 **Convert**. AWS SCT analyzes 您的原始程式碼檔案，判斷應用程式邏輯，並將程式碼中繼資料載入專案。此程式碼中繼資料包括 Java 類別、物件、方法、全域變數、介面等。

   在目標資料庫面板中， 會 AWS SCT 建立與來源應用程式專案類似的資料夾結構。您可以在這裡檢閱轉換後的應用程式程式碼。  
![\[要分析的 SQL 程式碼\]](http://docs.aws.amazon.com/zh_tw/SchemaConversionTool/latest/userguide/images/java-applications-project-analyze.png)

1. 儲存轉換後的應用程式程式碼。如需詳細資訊，請參閱[儲存轉換後的應用程式程式碼](#CHAP_Converting.App.Java.Save)。

您的 Java 應用程式可能包含與不同來源資料庫互動的 SQL 程式碼。您可以遷移至 PostgreSQL 其中數個來源資料庫。在此情況下，請確定您不會轉換與從遷移範圍排除的資料庫互動的 SQL 程式碼。您可以從轉換範圍中排除 Java 應用程式的來源檔案。若要這麼做，請清除您要從轉換範圍中排除之檔案名稱的核取方塊。

變更轉換範圍之後， AWS SCT 仍然會分析 SQL 程式碼和 Java 應用程式的所有來源檔案。然後，將您在轉換範圍中排除的所有來源檔案 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 專案中的應用程式程式碼，或從專案 AWS SCT 中移除 Java 轉換專案。

**新增額外的 Java 應用程式轉換專案**

1. 展開左側面板中的**應用程式**節點。

1. 選擇 **Java** 節點，然後開啟內容 （按一下滑鼠右鍵） 選單。

1. 選擇 **New application** (新增應用程式)。

1. 輸入建立新 Java 應用程式轉換專案所需的資訊。如需詳細資訊，請參閱[建立 Java 應用程式轉換專案](#CHAP_Converting.App.Java.Create)。

在您變更來源應用程式程式碼之後，請將其上傳至 AWS SCT 專案。

**上傳更新的應用程式程式碼**

1. 在左側面板中的**應用程式**下展開 **Java** 節點。

1. 選擇要更新的應用程式，然後開啟內容 （按一下滑鼠右鍵） 選單。

1. 選擇**重新整理**，然後選擇**是**。

   AWS SCT 從來源檔案上傳您的應用程式程式碼，並移除轉換結果。若要保留您在 中所做的程式碼變更 AWS SCT 和轉換結果，請建立新的 Java 轉換專案。

如果您的來源 Java 應用程式使用 MyBatis 架構， AWS SCT 會使用 MyBatis 組態檔案來剖析您的 SQL 程式碼。變更此檔案後，請將其上傳至 AWS SCT 專案。

**編輯 MyBatis 組態檔案的路徑**

1. 在左側面板中的**應用程式**下展開 **Java** 節點。

1. 選擇您的應用程式，然後選擇**設定**。

1. 選擇**瀏覽**，然後選擇 MyBatis 組態檔案。

1. 選擇**套用**。

1. 在左側面板中，選擇您的應用程式，開啟內容 （按一下滑鼠右鍵） 選單，然後選擇**重新整理**。

**移除 Java 應用程式轉換專案**

1. 在左側面板****的應用程式下展開 **Java** 節點。

1. 選擇要移除的應用程式，然後開啟內容 （按一下滑鼠右鍵） 選單。

1. 選擇**刪除**，然後選擇**確定**。

## 在 中建立 Java 應用程式轉換評估報告 AWS SCT
<a name="CHAP_Converting.App.Java.AssessmentReport"></a>

*Java 應用程式轉換評估報告*提供有關將 Java 應用程式中內嵌的 SQL 程式碼轉換為與目標資料庫相容格式的資訊。評估報告提供所有 SQL 執行點和所有原始程式碼檔案的轉換詳細資訊。評估報告也包含 AWS SCT 無法轉換之 SQL 程式碼的動作項目。

使用下列程序來建立 Java 應用程式轉換評估報告。

**建立 Java 應用程式轉換評估報告**

1. 在左側面板中的**應用程式**下展開 **Java** 節點。

1. 選擇要轉換的應用程式，然後開啟內容 （按一下滑鼠右鍵） 選單。

1. 選擇**轉換**。

1. 在**檢視**功能表上，選擇**評估報告檢視**。

1. 檢閱 **Summary** (摘要) 索引標籤。

   摘要****索引標籤如下所示，顯示 Java 應用程式評估報告中的執行摘要資訊。它會顯示所有 SQL 執行點和所有原始程式碼檔案的轉換結果。  
![\[Java 應用程式評估報告摘要索引標籤\]](http://docs.aws.amazon.com/zh_tw/SchemaConversionTool/latest/userguide/images/java-applications-summary.png)

1. 選擇將**陳述式儲存至 JSON**，將從 Java 應用程式擷取的 SQL 程式碼儲存為 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) 將內嵌的 SQL 程式碼轉換為 Pro\$1C 應用程式。這個特定的 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)。

您可以在單一專案中新增多個應用程式轉換 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 應用程式轉換專案**對話方塊。  
![\[新的 Pro*C 應用程式轉換專案對話方塊\]](http://docs.aws.amazon.com/zh_tw/SchemaConversionTool/latest/userguide/images/proc-application-new-project.png)

1. 在**名稱**中，輸入 Pro\$1C 應用程式轉換專案的名稱。由於每個資料庫結構描述轉換專案可以有一或多個子應用程式轉換專案，因此如果您新增多個專案，請選擇有意義的名稱。

1. 針對**位置**，輸入應用程式的來源碼位置。

1. 在來源樹狀目錄中，選擇應用程式使用的結構描述。請確定此結構描述是映射規則的一部分。 會以粗體 AWS SCT 強調映射規則一部分的結構描述。

1. 選擇**確定**以建立 Pro\$1C 應用程式轉換專案。

1. 在左側面板的應用程式節點中尋找 Pro\$1C **應用程式**轉換專案。

## 在 中轉換 Pro\$1C 應用程式 SQL 程式碼 AWS SCT
<a name="CHAP_Converting.App.ProC.Convert"></a>

將 Pro\$1C 應用程式新增至 AWS SCT 專案後，請將此應用程式中的 SQL 程式碼轉換為與您的目標資料庫平台相容的格式。使用下列程序來分析和轉換 中內嵌於 Pro\$1C 應用程式的 SQL 程式碼 AWS Schema Conversion Tool。

**轉換 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 您的原始程式碼檔案，判斷應用程式邏輯，並將程式碼中繼資料載入專案。此程式碼中繼資料包括 Pro\$1C 類別、物件、方法、全域變數、介面等。

   在目標資料庫面板中， 會 AWS SCT 建立與來源應用程式專案類似的資料夾結構。您可以在這裡檢閱轉換後的應用程式程式碼。  
![\[要分析的 SQL 程式碼\]](http://docs.aws.amazon.com/zh_tw/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. 選擇將**陳述式儲存至 CSV**，將 Pro\$1C 應用程式擷取的 SQL 程式碼儲存為 CSV 檔案。

1. 輸入 CSV 檔案名稱以儲存擷取的 SQL 程式碼，然後選擇**儲存**。

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. 選擇 **New application** (新增應用程式)。

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. 選擇**刪除**，然後選擇**確定**。

## 在 中建立 Pro\$1C 應用程式轉換評估報告 AWS SCT
<a name="CHAP_Converting.App.ProC.AssessmentReport"></a>

*Pro\$1C 應用程式轉換評估報告*提供將 Pro\$1C 應用程式中內嵌的 SQL 程式碼轉換為與目標資料庫相容格式的相關資訊。評估報告提供所有 SQL 執行點和所有原始程式碼檔案的轉換詳細資訊。評估報告也包含 AWS SCT 無法轉換之 SQL 程式碼的動作項目。

使用下列程序來建立 Pro\$1C 應用程式轉換評估報告。

**建立 Pro\$1C 應用程式轉換評估報告**

1. 在左側面板中的**應用程式**下展開 **Pro\$1C** 節點。

1. 選擇要轉換的應用程式，然後開啟內容 （按一下滑鼠右鍵） 選單。

1. 選擇**轉換**。

1. 在**檢視**功能表上，選擇**評估報告檢視**。

1. 檢閱 **Summary** (摘要) 索引標籤。

   摘要****索引標籤如下所示，顯示 Pro\$1C 應用程式評估報告中的執行摘要資訊。它會顯示所有 SQL 執行點和所有原始程式碼檔案的轉換結果。  
![\[Pro*C 應用程式評估報告摘要索引標籤\]](http://docs.aws.amazon.com/zh_tw/SchemaConversionTool/latest/userguide/images/proc-applications-summary.png)

1. 選擇將**陳述式儲存至 CSV**，將 Pro\$1C 應用程式擷取的 SQL 程式碼儲存為逗號分隔值 (CSV) 檔案。

1. （選用） 將報告的本機副本儲存為 PDF 檔案或逗號分隔值 (CSV) 檔案：
   + 選擇右上角**的儲存至 PDF**，將報告儲存為 PDF 檔案。

      PDF 檔案包含執行摘要、動作項目和應用程式轉換的建議。
   + 選擇右上角**的儲存至 CSV**，將報告儲存為 CSV 檔案。

     CSV 檔案包含動作項目、建議的動作，以及轉換 SQL 程式碼所需的手動工作預估複雜性。