你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。

从 Oracle 到 Azure PostgreSQL 的架构模式和应用程序转换

适用于 Visual Studio Code 的 PostgreSQL 扩展为 Oracle 架构和应用程序转换提供了引导式工作流。 架构转换支持 Azure Database for PostgreSQL 灵活服务器 和 Azure HorizonDB,用于架构验证和部署。 本指南介绍了架构模式和应用程序工作流如何组合在一起。 使用 架构转换教程 了解完整的配置和转换流程。 单独规划行数据迁移。

Important

架构和应用程序转换仅在Visual Studio Code可用。

架构转换和应用程序转换如何配合

对于组合架构和应用程序转换,请使用两个按顺序排列的工作流。 架构转换为数据库对象生成 PostgreSQL 数据定义语言(DDL),应用程序转换将更新调用它们的代码。 应用程序转换也可以独立运行。

架构转换

架构转换读取所选架构的 Oracle 数据字典,并使用你的 Microsoft Foundry 部署生成 PostgreSQL DDL。 该工具尝试在架构验证数据库中进行编译,并使用可用的静态检查来识别问题。 这些检查并不能证明具备等效的运行时行为或生产就绪性。 一次运行生成:

  • 位于 postgres_ddl 中、按 Oracle 架构和对象类型组织的对象级 PostgreSQL .sql 文件。
  • 包含发现、提取和转换结果、转换速率和对象级注释的 HTML 转换报告。
  • 可以在转换对象资源管理器中检查的对象映射和注释,包括需要手动更改的对象。
  • 使用 postgres_ddl 中对象文件进行单独部署操作的设置说明和脚本。
  • 描述架构中发现的 Oracle 模式及其如何映射到 PostgreSQL 的编码说明。

应用程序转换

应用程序转换针对数据库周边的 Oracle 特有代码:SQL 脚本、存储过程调用、加载控制文件、Shell 脚本和 Java 文件。 如果可用,架构转换指南中的编码说明会指导对对象名称、类型和调用约定的更改。 查看并测试这些更改;生成的笔记不能保证正确的应用程序行为。

可以在此扩展中转换与数据库相关的应用程序代码,或者将工作交给 GitHub Copilot 应用现代化扩展,以获取完整的现代化过程。 转换加载程序脚本或其他应用程序文件不会执行行数据迁移。

安排两个阶段的顺序

对于合并转换工作流,请先运行架构转换,以便应用程序转换可以使用其编码说明和转换的对象名称。 在转换应用程序代码之前,查看架构并完成必要的更改。 如果以后编辑 PostgreSQL 定义,请再次检查调用该定义的应用程序。 不支持重新运行已完成的架构转换。

先决条件

对于架构转换,请遵循 教程先决条件:

  • Visual Studio Code、PostgreSQL 扩展、支持的操作系统和Copilot登录。
  • Oracle 版本、元数据权限、连接和客户端配置。
  • 架构验证数据库、PostgreSQL 版本、权限和扩展。
  • Foundry 模型、资源身份验证和容量规划。

对于应用程序转换,还应确保源应用程序文件夹可供访问,并在接受生成的编辑之前保留其原始内容。

启用架构转换

该 pgsql.enableMigrations 设置控制 迁移 视图及其架构和应用转换命令。 默认情况下,此设置处于启用状态。 UI 保留这些转换工作流的标签,例如 Migrations 和 Create Migration Project。

如果侧边栏中未显示迁移视图,请打开 Visual Studio Code 设置(Windows/Linux 上为Ctrl+,;macOS 上为Cmd+,),并验证pgsql.enableMigrations是否设置为true。

创建架构转换 Project

Project 向导收集源、发现范围、架构验证数据库连接和模型配置。 本教程是主要指南;使用以下入口点和链接进行导航。

步骤 1:项目设置

  1. 在边栏中打开 迁移 视图。

  2. 通过以下方式之一启动新项目:

    • 如果工作区尚不包含架构转换Project,请在视图中选择“+ 创建迁移Project”。
    • 选择视图工具栏中的 + 按钮。
    • 右键单击资源管理器中的工作区文件夹,然后选择“打开迁移项目”。
  3. 在“Project名称”字段中输入名称。

  4. 选择 “下一步:Oracle 连接”。

带有 Project Name 字段的新建迁移 Project 页面屏幕截图。

此屏幕截图中的先决条件列表适用于 API 密钥身份验证。 还可以使用Microsoft Entra ID身份验证。

完成向导

按照每个页面对应的教程步骤进行操作:

向导阶段 描述
Oracle 连接和架构选择 连接到 Oracle。
发现、源权限和依赖项 查看发现结果。
模式验证数据库和扩展检查 配置架构验证数据库。
Foundry 资源、模型和身份验证 配置模型。

警告

转换使用DROP SCHEMA ... CASCADE删除与所选 Oracle 架构对应的架构,然后重新创建它们。 此操作将删除这些架构中的现有对象和数据,并且可以删除其他架构中的依赖对象。 使用空架构验证数据库或专用的未使用的架构验证数据库,该数据库不包含需要保留的对象或数据。

运行模式转换

创建Project后,运行架构转换并查看Project中的结果。

提取并转换架构

  1. 选择迁移以开始提取和转换。
  2. 监视提取和转换进度。
  3. 当项目显示架构转换已完成时,选择查看转换摘要。

转换完成后,HTML 报表会自动打开。 在转换摘要上选择转换报告可重新打开它。 单独查看发现、提取和转换总计;它们描述了不同的阶段。

检查已转换的对象

使用转换对象资源管理器比较已转换对象和未转换对象的可用定义并阅读注释。 请求和修复提供Copilot帮助;解决更新已审阅对象的记录状态,并刷新更新报表。 单独查看编译结果和部署包含情况。

有关依赖对象更正、包成员、手动编译和工作示例,请遵循Conversion 对象资源管理器。

准备部署

在转换摘要上,选择安装说明以打开生成的部署说明并显示安装目录。 查看包和工具生成的对象文件postgres_ddl,运行仅限验证的检查,然后针对在 Azure Database for PostgreSQL flexible server 或 Azure HorizonDB 上选择的目标数据库运行生成的部署脚本。 安装程序读取这些文件的最新保存内容以供部署,包括手动编辑和 Fix 更正。 手动添加到 postgres_ddl 的文件将被安装程序忽略。 生成安装程序文件不会部署数据库架构。

在生产使用之前,查看部署报告并独立验证数据和应用程序行为。 有关先决条件、数据库模式和命令,请参阅使用安装体验部署已转换的架构。

转换应用程序代码

将 Oracle 特定的应用程序代码(SQL 脚本、存储过程、加载程序控制文件、shell 脚本或Java文件)转换为与 PostgreSQL 兼容的等效项。 对于合并转换工作流,请使用已审核的架构输出作为上下文。 应用程序转换是一项预览功能。

选择转换方法

该扩展提供两个用于应用程序代码转换的路径:

  • 完整应用现代化:如果安装了 GitHub Copilot 应用 modernization 扩展,请选择 使用应用现代化进行迁移,继续查看模式转换中的编码说明。 选择 “查看编码说明 ”以查看生成的指南,然后再继续操作。
  • 仅限数据库选项:若要在此扩展中仅转换与数据库相关的应用程序代码,请选择 “使用 PostgreSQL 扩展进行迁移”。

在扩展中转换应用程序代码

  1. 在 应用程序迁移 卡上,启动应用程序转换工作流。 如果出现方法选择器,请选择 “使用 PostgreSQL 扩展进行迁移”。
  2. 在“ 转换应用程序 ”页中, 选择“选择 Oracle 应用程序以转换 ”,然后选择包含 Oracle 应用程序代码的文件夹。
  3. 选择PostgreSQL 连接和PostgreSQL 数据库作为转换上下文。
  4. 如果数据库列表为空,请选择“ 加载数据库 ”。
  5. 选择 “转换应用程序 ”以启动转换。

使用Copilot工具进行应用程序转换

该扩展注册两个用于转换帮助的Copilot语言模型工具:

  • Oracle 客户端代码应用程序转换器 (pgsql_migration_oracle_app):使用提示模板和架构转换中的编码指南将 Oracle 客户端应用程序代码转换为 PostgreSQL 等效项。 接受以下参数:

    • 应用程序代码库文件夹 (必需):要转换的代码的位置。
    • 编码备注位置路径(可选):架构转换产生的编码备注的路径。
    • Postgres DB 名称 (可选):用于转换上下文的 PostgreSQL 数据库的名称。
    • Postgres DB 连接 (可选):PostgreSQL 数据库的连接名称。
  • 显示 Oracle 到 Postgres 迁移报告 (pgsql_migration_show_report):显示架构转换报告。 需要 报表文件路径 参数。

有关使用Copilot工具的详细信息,请参阅Copilot集成。

比较已转换的文件

若要查看当前的架构转换输出,请使用Conversion 对象资源管理器导航源到目标映射,包括具有多个目标定义的对象。

若要比较转换后的应用程序文件(.sql、、.sh.ctl.load或.java),请在资源管理器中右键单击该文件,然后选择“比较应用程序迁移文件对”。 查看原始代码和转换后的代码,并使用更正后的 PostgreSQL 架构测试应用程序。

对于具有旧式配对文件夹布局的项目,比较 DDL 迁移文件对要求在 folder\oracle\SCHEMA_NAME\DDL-TYPE 和 folder\postgres\SCHEMA_NAME\DDL-TYPE 下具有匹配的路径。 此布局不是当前 postgres_ddl 包的导航路径。

管理转换项目

使用边栏中的 “迁移 ”视图管理项目:

Action 说明
打开 Migration Project 在仪表板中打开现有转换Project。
在资源管理器中显示 在资源管理器视图中显示项目文件夹。
删除 删除转换 Project。 系统会提示在删除之前进行确认。
刷新 重新加载当前工作区中的转换项目列表。