3.x: Upgrade bundled orafce from 4.9.2 to 4.16.13
维护者通常 3 天内回复
评估
- 难度
- 5/5
- 预计耗时
- 一周以上
- 新手友好度
- 25/100
调研方向
Start with gpcontrib/orafce/README.gp and the current regression schedule in gpcontrib/orafce; identify which of the 21 SQL tests can run in MPP before expanding coverage. Then compare the local patches with upstream tag VERSION_4_16_13 and preserve applicable changes. Done means the update chain, fresh install, upgrade and pg_upgrade paths pass, licensing checks stay green, and release notes describe user-visible changes.
由索引模型根据 Issue 内容生成。
描述
Summary
The bundled gpcontrib/orafce is 4.9.2 (META.json:5; orafce.control default_version = '4.9', imported 2024-07). Propose upgrading it to 4.16.13 — the current release of the upstream series that supports PostgreSQL 16 — as part of 3.0.
orafce is the Oracle-compatibility layer many migration workloads depend on, so refreshing it is user-visible content for a major release, not just dependency hygiene.
Current state
- 4.9.2 is roughly seven minor releases and 2+ years behind upstream (4.10 → 4.16.x). 4.16.13 is currently packaged for PG16 by PGDG and distributions.
- The module is imported as a git subtree of
orafce/orafce(workflow documented ingpcontrib/orafce/README.gp), so the upgrade is agit subtree pullto tagVERSION_4_16_13, with local patches applied explicitly afterwards. - PG16 compatibility today is fine: there are 9
#if PG_VERSION_NUM >= 160000guards in the code, and CI runsgpcontrib/orafce:installcheckas part of the requiredic-gpcontribcheck. This issue is about refreshing content, not fixing a build. - Test coverage is thin:
Makefile:76,92runsREGRESS = orafceplus--schedule=parallel_schedule, but the schedule only listsinit,dbms_pipe_session_A,dbms_pipe_session_B— that is 4 of the 21 SQL test files (~19%). Thedbms_alerttests are commented out as MPP-unsuitable. - Local delta that must survive the upgrade:
regexp_not_like()added toorafce--4.8--4.9.sqlandorafce--4.9.sql(7bda69676d5);- MPP test adaptations (
gp_distributed_by,gp_partition_by,nlssort) and rebranding (b64d461e37c); - locale handling change in
others.c(4af1cf5a09b).
Why this belongs in 3.0
- A major release is the natural window to refresh a bundled dependency; doing it now avoids turning this into a multi-year jump.
- orafce is user-facing: accumulated upstream fixes and compatibility improvements can be summarized as a concrete 3.0 highlight in the release notes.
- It keeps future refreshes cheap — the next one can target a handful of minor releases instead of seven.
Work items
- Prerequisite: expand orafce regression coverage — move as many of the 21 test files into the schedule as can run single-node/MPP, keeping
dbms_alertskipped with an explicit reason. Without this, behavior changes from the upgrade are invisible. -
git subtree pullorafce/orafceat tagVERSION_4_16_13(perREADME.gp). - Re-apply the local delta:
regexp_not_like()(check whether upstream 4.16 has adopted it — drop the patch if so), MPP test adaptations,others.clocale handling, rebranding. - Ship the full upgrade chain from 4.9 to 4.16.13 (
orafce--4.9--4.10.sql…orafce--4.16.13.sql) plus the new base install script; bumporafce.controldefault_versionandMETA.json. - Verify the extension update path:
CREATE EXTENSION orafce VERSION '4.9'; ALTER EXTENSION orafce UPDATE;, and apg_upgradefrom a 2.x cluster (pg_upgrade'supdate_extensions.sqlemitsALTER EXTENSION orafce UPDATE). - Check licensing: orafce is 0BSD (
COPYRIGHT.orafce), registered underLICENSE:542+licenses/LICENSE-orafce.txt; confirm copyright/NOTICE text is still accurate after the update and RAT stays green. - Run the required
ic-gpcontribcheck plus broader ICW; prepare a short "user-visible changes" section for the 3.0 release notes.
Acceptance criteria
\dx orafcereports 4.16.13; fresh install, update from 4.9, and a 2.x → 3.0pg_upgradeall succeed.- Existing orafce behavior is unchanged except for documented upstream fixes/features; the expanded test suite passes.
regexp_not_like()and the other Cloudberry-specific behavior remain available.- License/NOTICE and RAT checks stay green; CI
ic-gpcontribis green. - A user-visible changes section is ready for the 3.0 release notes.
Risks
- Compatibility-layer semantics changes may alter results for Oracle-migration workloads; needs release-note attention.
- Local SQL patches complicate the subtree merge and the upgrade-script chain.
- Expanding tests in an MPP environment may require per-test expected-output adaptation — scope the prerequisite before starting the merge.
References
- orafce 4.16.13 packaged for PG16 (PGDG): https://www.postgresql.org/message-id/E1xDjRr-0000000146B-230h%40atalia.postgresql.org
- Upstream project and tags: https://github.com/orafce/orafce (
VERSION_4_16_13) - Subtree workflow:
gpcontrib/orafce/README.gp
- 主要语言
- C
- 星标
- 1.4k
- 派生
- 265
- 平均合并
- 3 天 22 小时
- 30 天内合并 PR
- 82
环境准备
- 没有 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
apache/cloudberry 的其他 Issue
-
[Bug] Expand fails to recognize user-defined tablespaces可能已有人在做 @nix-oss 于 78 天前认领。 未关闭type: Bug
难度 2/5 1-3 小时 新手友好度 76/100
apache/cloudberry#1885 · 2 个 reaction ·
维护者通常 3 天内回复
-
gpexpand first stage fails: 'SyncPackages' object has no attribute 'ret' (extension sync never runs; regression)可能已有人在做 @talmacschen-arch 于 139 天前认领。 未关闭
难度 2/5 1-3 小时 新手友好度 86/100
apache/cloudberry#1825 ·
维护者通常 3 天内回复
-
type: Bug
难度 4/5 3-5 天 新手友好度 48/100
apache/cloudberry#2235 ·
维护者通常 3 天内回复
-
难度 3/5 半天 新手友好度 30/100
apache/cloudberry#2224 ·
维护者通常 3 天内回复
-
[Bug] GPORCA: “could not find MotionState” for correlated EXISTS with LIMIT and a scalar subquery可能已有人在做 @Alena0704 于 6 天前认领。 未关闭type: Bug
apache/cloudberry#2221 · 已指派 1 人 ·
维护者通常 3 天内回复
查看 apache/cloudberry 的全部 Issue
相似的 Issue
-
[compiler-rt] Rtsan-aarch64-NoInstTest: error: no such file or directory: 'NOTFOUND' (libatomic)未关闭build-problem compiler-rt:rtsan platform:linux
难度 2/5 1-3 小时 新手友好度 63/100
llvm/llvm-project#239039 ·
维护者通常 1 天内回复
-
component:obi contribfest go test
难度 2/5 1 小时以内 新手友好度 83/100
open-telemetry/opentelemetry-ebpf-instrumentation#4143 · 1 条评论 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 72/100
维护者通常 1 天内回复
-
Bug :bug:
难度 2/5 1-3 小时 新手友好度 72/100
sonic-net/sonic-buildimage#30541 ·
维护者通常 1 天内回复