本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 使用 C\$1\$1 应用程序转换 SQL 代码 AWS Schema Conversion Tool
对于 Oracle 到 PostgreSQL 的转换， AWS SCT 您可以使用转换嵌入到 C\$1\$1 应用程序中的 SQL 代码。这个特定的 C\$1\$1 应用程序转换器了解应用程序逻辑。它收集位于不同应用程序对象中的语句，例如函数、参数、局部变量等。
由于这种深入的分析，C\$1\$1 应用程序 SQL 代码转换器比通用转换器的转换结果更好。
## 在中创建 C\$1\$1 应用程序转换项目 AWS SCT
您可以仅创建 C\$1\$1 应用程序转换项目，以便将 Oracle 数据库架构转换为 PostgreSQL 数据库架构。请务必在项目中添加包含源 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_cn/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
将 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. 对于**编译器类型**，请选择用于 C\$1\$1 应用程序源代码的编译器。 AWS SCT **支持以下 C\$1\$1 编译器：**微软 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. 选择 “**转换**”。 AWS SCT 分析您的源代码文件，确定应用程序逻辑，并将代码元数据加载到项目中。此代码元数据包括 C\$1\$1 类、对象、方法、全局变量、接口等。
在目标数据库面板中， AWS SCT 创建与源应用程序项目类似的文件夹结构。您可以在此查看转换后的应用程序代码，如下所示。
![\[要分析的 SQL 代码\]](http://docs.aws.amazon.com/zh_cn/SchemaConversionTool/latest/userguide/images/cplusplus-applications-project-analyze.png)
1. 保存转换后的应用程序代码。有关更多信息，请参阅 [保存转换后的应用程序代码](#CHAP_Converting.App.Cplusplus.Save)。
## 使用保存转换后的应用程序代码 AWS SCT
使用以下过程保存转换后的应用程序代码。
**保存转换后的应用程序代码**
1. 展开目标数据库面板中**应用程序** 下的 **C\$1\$1** 节点。
1. 选择转换后的应用程序，然后选择**保存**。
1. 输入保存转换后的应用程序代码的文件夹路径，然后选择**选择文件夹**。
## 在中管理 C\$1\$1 应用程序转换项目 AWS SCT
您可以添加多个 C\$1\$1 应用程序转换项目、编辑转换设置、更新 C\$1\$1 应用程序代码或从项目中删除 C\$1\$1 转换 AWS SCT 项目。
**添加其他 C\$1\$1 应用程序转换项目**
1. 展开左侧面板中的**应用程序**节点。
1. 选择 **C\$1\$1** 节点，然后打开上下文（右键单击）菜单。
1. 选择 **New application**（新建应用程序）。
1. 输入创建新的 C\$1\$1 应用程序转换项目所需的信息。有关更多信息，请参阅 [创建 C\$1\$1 应用程序转换项目](#CHAP_Converting.App.Cplusplus.Create)。
您可以为项目中的所有 C\$1\$1 应用程序转换项目指定转换设置。 AWS SCT
**编辑所有 C\$1\$1 应用程序的转换设置**
1. 在**设置**菜单上，选择**项目设置**，然后选择 **应用程序转换**。
1. 对于**编译器类型**，请选择用于 C\$1\$1 应用程序源代码的编译器。 AWS SCT **支持以下 C\$1\$1 编译器：**微软 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
*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 代码所需的估计人工操作的复杂性。