使用 Java 应用程序转换 SQL 代码 AWS Schema Conversion Tool - AWS Schema Conversion Tool
创建 Java 应用程序转换项目转换 Java 应用程序 SQL 代码保存转换后的应用程序代码管理 Java 应用程序转换项目创建 Java 应用程序转换评估报告

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用 Java 应用程序转换 SQL 代码 AWS Schema Conversion Tool

对于 Oracle 到 PostgreSQL 的转换， AWS Schema Conversion Tool 您可以使用转换嵌入到 Java 应用程序中的 SQL 代码。这个特定的 Java 应用程序转换器了解应用程序逻辑。它收集位于不同应用程序对象中的语句，例如函数、参数、局部变量等。

由于这种深入的分析，与通用转换器相比，Java 应用程序 SQL 代码转换器的转换结果更好。

如果您的 Java 应用程序使用该 MyBatis 框架与数据库交互，则可以使用转换嵌入 AWS SCT 到 XML 文件和注释中的 SQ MyBatis L 语句。要了解这些 SQL 语句的逻辑，请 AWS SCT 使用 MyBatis配置文件。 AWS SCT 可以在您的应用程序文件夹中自动发现此文件，也可以手动输入该文件的路径。

在中创建 Java 应用程序转换项目 AWS SCT

您可以仅创建 Java 应用程序转换项目，以便将 Oracle 数据库架构转换为 PostgreSQL 数据库架构。请务必在项目中添加包含源 Oracle 架构和目标 PostgreSQL 数据库的映射规则。有关更多信息，请参阅 在 AWS Schema Conversion Tool 中映射数据类型。

您可以在单个项目中添加多个应用程序转换 AWS SCT 项目。使用以下过程创建 Java 应用程序转换项目。

创建 Java 应用程序转换项目

  1. 创建数据库转换项目，然后添加源 Oracle 数据库。有关更多信息，请参阅在中启动和管理项目 AWS SCT和将服务器添加到项目中 AWS SCT。

  2. 添加包含源 Oracle 数据库和目标 PostgreSQL 数据库的映射规则。您可以添加目标 PostgreSQL 数据库，也可以在映射规则中使用虚拟的 PostgreSQL 目标数据库平台。有关更多信息，请参阅在 AWS Schema Conversion Tool 中映射数据类型和在 AWS Schema Conversion Tool 中映射到虚拟目标。

  3. 在视图菜单上，选择主视图。

  4. 在应用程序菜单上，选择新建 Java 应用程序。

    随即出现创建 Java 应用程序转换项目对话框。

    新 Java 应用程序转换项目对话框

  5. 对于名称，输入 Java 应用程序转换项目名称。每个数据库架构转换项目都可以有一个或多个子应用程序转换项目，因此如果您添加多个项目的话，请选择一个有意义的名称。

  6. 对于位置，输入您的应用程序源代码的位置。

  7. （可选）对于MyBatis 配置文件，请输入 MyBatis 配置文件的路径。 AWS SCT 扫描您的应用程序文件夹以自动发现此文件。如果此文件不在您的应用程序文件夹中，或者您使用了多个配置文件，请手动输入路径。

  8. 在源树状图中，选择应用程序所用的架构。确保此架构是映射规则的一部分。 AWS SCT 以粗体突出显示作为映射规则一部分的架构。

  9. 选择确定以创建 Java 应用程序转换项目。

  10. 在左侧面板的应用程序节点中找到您的 Java 应用程序转换项目。

转换你的 Java 应用程序 SQL 代码 AWS SCT

将 Java 应用程序添加到 AWS SCT 项目后，将此应用程序中的 SQL 代码转换为与目标数据库平台兼容的格式。按照以下过程在 AWS Schema Conversion Tool中分析和转换嵌入 Java 应用程序的 SQL 代码。

转换 SQL 代码

  1. 展开左侧面板中应用程序下的 Java 节点。

  2. 选择要转换的应用程序，然后打开上下文（右键单击）菜单。

  3. 选择 “转换”。 AWS SCT 分析您的源代码文件，确定应用程序逻辑，并将代码元数据加载到项目中。此代码元数据包括 Java 类、对象、方法、全局变量、接口等。

    在目标数据库面板中， AWS SCT 创建与源应用程序项目类似的文件夹结构。在这里，您可以查看转换后的应用程序代码。

    要分析的 SQL 代码

  4. 保存转换后的应用程序代码。有关更多信息，请参阅 保存转换后的应用程序代码。

您的 Java 应用程序可能包含与不同源数据库交互的 SQL 代码。您可以将其中几个源数据库迁移到 PostgreSQL。在这种情况下，请确保不要转换与已排除在迁移范围之外的数据库交互的 SQL 代码。您可以将 Java 应用程序的源文件排除在转换范围之外。为此，请清除要排除在转换范围之外的文件名的复选框。

更改转换范围后， AWS SCT 仍会分析 Java 应用程序的所有源文件的 SQL 代码。然后，将您排除在转换范围之外的所有源文件 AWS SCT 复制到目标文件夹。通过此操作，可以在保存转换后的应用程序文件后生成应用程序。

使用保存转换后的应用程序代码 AWS SCT

使用以下过程保存转换后的应用程序代码。

保存转换后的应用程序代码

  1. 展开目标数据库面板中应用程序下的 Java 节点。

  2. 选择转换后的应用程序，然后选择保存。

  3. 输入保存转换后的应用程序代码的文件夹路径，然后选择选择文件夹。

如果您的源 Java 应用程序使用该 MyBatis 框架，请确保更新配置文件以使用新数据库。

在中管理 Java 应用程序转换项目 AWS SCT

您可以添加多个 Java 应用程序转换项目、更新 AWS SCT 项目中的应用程序代码或从项目中删除 Java 转换 AWS SCT 项目。

添加其他 Java 应用程序转换项目

  1. 展开左侧面板中的应用程序节点。

  2. 选择 Java 节点，并打开上下文 (右键单击) 菜单。

  3. 选择 New application（新建应用程序）。

  4. 输入创建新的 Java 应用程序转换项目所需的信息。有关更多信息，请参阅 创建 Java 应用程序转换项目。

更改源应用程序代码后，将其上传到 AWS SCT 项目中。

上传更新的应用程序代码

  1. 展开左侧面板中应用程序下的 Java 节点。

  2. 选择要更新的应用程序，然后打开上下文（右键单击）菜单。

  3. 选择刷新，然后选择是。

    AWS SCT 从源文件上传您的应用程序代码并删除转换结果。要保留您在中进行的代码更改 AWS SCT 和转换结果，请创建一个新的 Java 转换项目。

如果您的源 Java 应用程序使用 MyBatis 框架，则 AWS SCT 使用 MyBatis 配置文件来解析您的 SQL 代码。更改此文件后，将其上传到 AWS SCT 项目中。

编辑 MyBatis 配置文件的路径

  1. 展开左侧面板中应用程序下的 Java 节点。

  2. 选择您的应用程序，然后选择设置。

  3. 选择 “浏览”，然后选择 MyBatis配置文件。

  4. 选择应用。

  5. 在左侧面板中，选择应用程序，打开上下文（右键单击）菜单，然后选择刷新。

删除 Java 应用程序转换项目

  1. 展开左侧面板中应用程序下的 Java 节点。

  2. 选择要删除的应用程序，然后打开上下文（右键单击）菜单。

  3. 选择删除，然后选择确定。

在中创建 Java 应用程序转换评估报告 AWS SCT

Java 应用程序转换评估报告提供了有关将 Java 应用程序中嵌入的 SQL 代码转换为与目标数据库兼容的格式的信息。评估报告提供了所有 SQL 执行点和所有源代码文件转换的详细信息。评估报告还包括针对 AWS SCT 无法转换的 SQL 代码的操作项目。

使用以下过程创建 Java 应用程序转换评估报告。

创建 Java 应用程序转换评估报告

  1. 展开左侧面板中应用程序下的 Java 节点。

  2. 选择要转换的应用程序，然后打开上下文（右键单击）菜单。

  3. 选择转换。

  4. 在视图菜单上，选择评估报告视图。

  5. 查看 Summary 选项卡。

    如下所示的摘要选项卡显示了 Java 应用程序评估报告中的执行摘要信息。它显示所有 SQL 执行点和所有源代码文件的转换结果。

    “Java 应用程序评估报告摘要”选项卡

  6. 选择将语句保存为 JSON，将从 Java 应用程序中提取的 SQL 代码另存为 JSON 文件。

  7. （可选）将报告的本地副本另存为 PDF 文件或逗号分隔值（CSV）文件。

    • 选择右上角的保存为 PDF，将报告另存为 PDF 文件。

      PDF 文件包含应用程序转换的执行摘要、操作项和建议。

    • 选择右上角的保存为 CSV，将报告另存为 CSV 文件。

      CSV 文件包含操作项、推荐的操作以及转换 SQL 代码所需的估计人工操作的复杂性。