使用 Modernize CLI 评估依赖 Oracle 的应用程序代码,并创建一个计划,将其转换为 PostgreSQL。 工作流支持Java和.NET应用程序,使用应用程序源和可选的导出数据库定义,而不是连接到实时目标数据库。
Important
新式 CLI 中的 Oracle 到 PostgreSQL 应用程序迁移目前为公开预览版。 此工作流更改应用程序代码;它不会迁移数据库服务器或客户数据、部署云基础结构或建立生产就绪情况。 对本文中的工作流使用本地执行。
支持的方案
评估标识应用程序提供程序、配置、SQL、ORM 映射、序列和例程调用中的活动 Oracle 依赖项。 语言特定的转换技能包括:
| Application | 转换范围示例 |
|---|---|
| Java | Oracle JDBC、JPA/Hibernate 映射、SQL、序列、例程协定、测试和驱动程序打包。 |
| .NET | Oracle.DataAccess 和 Oracle.ManagedDataAccess、ADO.NET、Dapper、EF/EF Core 映射、SQL、例程协定、Npgsql、测试和发布输出。 |
工作流不适用于仅限 PostgreSQL 的应用程序、非 Oracle 源迁移或数据库服务器评估。 工作流面向应用程序代码或配置使用的 Oracle 依赖项。 仅在文档中找到的 Oracle 引用或未使用的 Oracle 库不足以标识迁移目标。
此基于源的工作流支持Java和.NET应用程序,并且可以使用可选的 PostgreSQL DDL 导出来为转换提供依据。 它不需要实时数据库连接或应用程序停机,也不会自动添加Azure托管标识或更改应用程序的身份验证策略。 单独的 Oracle 到 PostgreSQL Java迁移体验提供了一个Java迁移任务,用于更新数据库客户端进行托管标识身份验证并转换 SQL,可以选择使用数据库架构转换期间生成的编码说明。
Prerequisites
- 现代化 CLI 及其GitHub身份验证先决条件。
- Oracle 相关Java或.NET应用程序的本地签出。
-
Node.js 22 或更高版本可在你的
PATH上作为node使用。 此要求适用于迁移帮助程序;新式 CLI 捆绑运行时不会替换它。 不需要 npm 运行时包。 - 为了进行转换,应用程序的 JDK 和生成工具或其.NET SDK 和生成工具。
- 对于 PostgreSQL 运行时验证,需要一个正在运行的 Docker 引擎,可以运行临时的本地 PostgreSQL 容器。
- 源转换之前,附加的 Git 分支上已提交的应用程序基线。
评估不会生成或测试应用程序、运行 Docker、连接到数据库或更改应用程序源。 在运行之前准备依赖项;评估不会安装工具或以交互方式进行身份验证。
提供可选数据库定义
仅凭应用程序代码即可进行评估和转换。 若要提供目标架构协定,请在应用程序存储库 .github\modernize\oracle-postgres.json中添加以下可选文件:
{
"postgres-ddl-folder": "database\\postgres",
"options": ["tests"]
}
将这些设置与任何现有配置合并,而不是替换它。
| 设置 | Purpose |
|---|---|
postgres-ddl-folder |
只读 PostgreSQL DDL 导出(按对象文件或仅架构转储)。 |
oracle-ddl-folder |
可选、独立的原始 Oracle 定义,以帮助保留源行为。 |
oracle-schema |
提供 Oracle DDL 文件夹时的确切 Oracle 架构选择器。 |
options |
要显式启用的转换操作,如下表所述。 |
| 选项 | Purpose |
|---|---|
tests |
启用基线支持、测试生成和故障测试修复。 |
必须显式启用转换操作。 省略的操作将保持关闭状态。
所有设置和配置文件本身都是可选的。 相对路径从应用程序根目录解析。 省略仅代码操作的 DDL 设置;如果显式提供的文件夹不存在、为空或无效,则这是错误,而不是回退到仅代码评估。
使用专用的仅限架构的 UTF-8 导出文件夹。 请勿包含客户数据、文件系统链接或可执行的 SQL 客户端包含项。 支持的 PostgreSQL 文件扩展名为 .sql、.psql、.ddl、.pgsql、.fnc、.prc、.vw 和 .trg。 忽略文本和 Markdown 注释。 对象标识来自 DDL 声明,而不是文件名。
DDL 快照描述导出的协定,而不是实时数据库的当前内容或特权。 导出中缺失的对象,并不证明其在实时数据库中不存在。 明确审查存在歧义的例程重载和不受支持的语法结构。
请勿向此配置中添加凭据或活动连接配置文件。 持久性目标写入以及诸如 create-persistent-ddl 和 test-target-writes 之类的选项均不受支持。 DDL 路径是存储库设置,而不是新的 modernize assess 命令行选项。
评估应用程序就绪情况
附加数据库评估技能需要完全分析。 默认的 Issue only 设置不会运行该功能。
交互模式(TUI)
在应用程序目录中,运行现代化代理:
modernize从主菜单中选择 “评估 ”。
选择 当前文件夹 以评估应用程序,或 手动输入 以输入本地应用程序路径。
选择与应用程序相关的评估域,然后继续执行评估配置。
在 “常规/分析覆盖范围” 下,选择 “完全分析”,然后选择 “继续”。
选择“ 在本地评估”。
输入输出路径,或使用默认值,然后开始评估。
CLI 使用存储库证据在适用时选择 Oracle 到 PostgreSQL 应用程序评估。 有关交互式屏幕的详细信息,请参阅 Batch 评估:交互式模式。
无头模式
创建一个评估配置文件,例如 C:\configs\database-assessment.yml,并使用以下设置:
analysisCoverage: full
将此设置与任何现有配置合并,而不是替换其他评估设置。 如以下命令所示,将该文件传给 --assess-config,并将源、配置和输出路径替换为你自己的路径:
modernize assess `
--source C:\src\oracle-app `
--assess-config C:\configs\database-assessment.yml `
--output-path C:\reports\oracle-app `
--format markdown `
--delegate local `
--no-tty `
--prompt 'Assess Oracle-to-PostgreSQL application-code migration readiness.'
或者,在Windows上,通过设置%USERPROFILE%\.modernize\assessment-config.yaml更新位于assessment-config.yaml的现有用户级analysisCoverage: full文件。 如果使用该文件,请从命令中省略 --assess-config 。 显式 --assess-config 路径优先于用户级文件。
Note
可选 --prompt 描述你的目标或用于附加数据库评估功能的范围。 它不会更改 Modernize CLI 的内置 AI 分析。 使用 DDL 路径和转换选项的存储库配置;提示不会配置这些设置。
可以省略 --prompt。 启用 完全分析 后,CLI 使用存储库证据选择 Oracle 到 PostgreSQL 应用程序评估(如果适用)。 该评估用于评估迁移准备情况;它不会转换应用程序代码。 转换在计划执行期间单独运行。
查看评估报告
打开生成的应用程序报表,并按照 Oracle 到 PostgreSQL 应用就绪性。 外部报表发布在当前存储库报表的index.html目录下,采用自包含的index.md或externals\oracle-to-postgresql-app-assessment形式。
评估执行有限、只读的静态检查。 已完成的报表意味着报表生成已完成,而不是应用程序转换或运行时验证通过。
- 如果评估找不到活动的 Oracle 应用程序使用情况,则工作流将跳过评估,而不是生成迁移报告。
- 如果评估不完整,请在规划转换之前查看报告的范围限制。
- 如果提供无效的 DDL,请更正并重新运行,而不要认为结果只会是纯代码。
评估不会自动创建转换任务。 接下来创建并审查现代化计划。
创建转换计划
从可丢弃的已提交示例或测试分支开始。 使用一个请求,将隔离的本地验证与禁止访问客户数据库区分开来:
$request = @'
Migrate this Oracle-dependent Java application to PostgreSQL using the offline
application adapter and the optional repository DDL and test configuration.
Allow disposable task-owned local PostgreSQL Docker containers for validation
of real application JDBC and ORM paths with synthetic data and cleanup.
Do not access customer or production databases, deploy cloud infrastructure,
change authentication policy, or perform unrelated framework upgrades.
'@
modernize plan create $request `
--source C:\src\oracle-app `
--language java `
--plan-name oracle-postgres `
--assess-file-path C:\reports\oracle-app\reports\report-<id>\index.md `
--delegate local `
--no-tty
将 --assess-file-path 该值替换为评估运行打印的实际应用程序评估报告路径,包括任何存储库和版本控制报表目录。 不要字面复制占位符 <id> 。
有关更多规划选项,请参阅 Modernize CLI 命令参考:plan create。
对于.NET应用程序,请更改请求来描述.NET应用程序及其 ADO.NET 或 ORM 路径,并使用--language dotnet。
在执行之前,请查看生成的计划和任务列表:
- 对于Java,请确认转换任务使用
migration-oracle-to-postgresql-app-java。 - 对于.NET,请确认它使用
migration-oracle-to-postgresql-app-dotnet。 - 在预期的应用程序边界内保留转换,并保留不相关的提供程序和公共行为。
- 允许对任务专属的本地 PostgreSQL Docker 环境进行验证。 不要实施仅限模拟的限制,也不要将本地测试容器与云部署混淆。
- 查看基线、构建、测试、打包和清理要求。
现有Javamigration-oracle-to-postgresql技能是不同的工作流。 不要将其替换为脱机应用程序适配器。
执行并验证
查看计划后,运行:
modernize plan execute `
--source C:\src\oracle-app `
--language java `
--plan-name oracle-postgres `
--delegate local `
--no-tty
对 .NET 计划使用--language dotnet。 Modernize CLI 管理任务排序、进度、分支和提交。
转换使用应用程序证据来更新审阅范围内的提供程序、配置、SQL、映射、例程协定和打包。 它不会进行不相关的体系结构、框架或身份验证更改。
运行时验证使用真正的应用程序数据库访问路径,针对任务专用的临时 PostgreSQL 容器,并结合合成数据、断言和清理。 仅编译和模拟并不能证明 PostgreSQL 兼容性。
如果 Docker 不可用,则依赖验证仍然不完整。 默认情况下,工作流不会安装 Docker 或启动 Docker Desktop。 启动已安装的 Docker Desktop 需要存储库配置中的显式 start-docker-desktop 选项。
解读转换结果
查看计划工作文件夹 oracle-postgres\<task-id>下的任务证据,包括 conversion-report.md 和 conversion-state.json。 检查已更改的文件、问题处置结果、本机测试结果、打包、Docker 测试夹具清理和剩余操作。
| 结果 | Meaning |
|---|---|
RUNTIME_VALIDATION_NEEDED |
最佳的离线转化效果。 即使隔离的 Docker 测试通过,客户目标验证和生产就绪情况检查仍是必需的。 |
PARTIAL |
所需的行为被推迟,或所需的验证失败或无法运行。 不要将此结果视为已完成的迁移。 |
这两种结果都不意味着可用于生产环境 READY。 在生产推出之前,在你自己的受控环境中验证特定于部署的架构、特权、身份验证、代表性工作负载和操作行为。 迁移数据库数据和预配目标服务是单独的活动。