Skip to content

fix: 完善 KingbaseES 三种兼容模式适配与回归测试 - #886

Open
fuziran wants to merge 15 commits into
APIJSON:mainfrom
fuziran:feature/Kingbase-Compatibility-Fit-PR
Open

fuziran wants to merge 15 commits into
APIJSON:mainfrom
fuziran:feature/Kingbase-Compatibility-Fit-PR

Conversation

@fuziran

@fuziran fuziran commented Nov 20, 2026

Copy link
Copy Markdown
Contributor

变更说明

本 PR 是 #868 的后续修复,针对真实数据库验证中发现的问题,完善 KingbaseES MySQL、Oracle、SQL Server 三种兼容模式下的 SQL 生成、JDBC 执行及数据类型处理,并补充回归测试。

主要改动

  • 模式识别:新增 KINGBASE_AUTO 配置入口,通过 SHOW database_mode 识别实际兼容模式,按数据源缓存识别结果并选择对应方言。
  • MySQL 模式:完善 JSON/JSONB、XML、时间及无符号类型的参数绑定和结果转换,修复会话设置、CTE 参数顺序及 UPSERT 等场景。
  • Oracle 模式:修复分页、JSON 条件、HAVING 别名解析、生成主键回读及存储过程调用。
  • SQL Server 模式:完善日期、正则、JSON 和特殊类型处理,修复 JOIN、子查询权限及分页相关问题,对齐 fix(sql): skip TSQL paging for aggregates without @group #885 的无分组聚合分页规则。
  • 回归测试:补充 JOIN 从表 JSON 投影、JDBC 异常处理、驱动合约及原生数据库行为回归测试。

配置兼容性

本次统一使用 KINGBASE_AUTO 作为三种兼容模式的配置入口:

  • 原先将 @database 或后端 DEFAULT_DATABASE 配置为 KINGBASE_MYSQL、KINGBASE_ORACLE、KINGBASE_SQLSERVER 的项目,需要改为 KINGBASE_AUTO。
  • 三个具体模式标识保留为内部方言及后端期望模式校验标识,不再接受为直接配置值。
  • 原有 KINGBASE 入口保持原行为,不自动探测兼容模式。

该调整涉及已有接入配置,迁移方式已补充到中文文档中,请维护者重点确认是否需要保留旧配置入口作为过渡。

Kingbase JDBC 驱动仍由应用提供。核心 ORM 不新增生产驱动依赖,Maven 中仅增加可选的驱动测试配置。

测试验证

Maven 构建及已执行的自动化回归测试通过,原生数据库行为基线比对未发现差异。

实库验证使用以下数据库及 JDBC 驱动版本:

KingbaseES 兼容模式 数据库版本 JDBC 驱动包版本
MySQL V009R003C018PS008 9.0.0-v9r3c18b0003
Oracle V009R002C016PS003 9.0.0-v9r2c16b0006
SQL Server V009R004C019 9.0.0-v9r4c19b0004

已针对三种兼容模式中本次改动涉及的功能进行定向实库验证,主要覆盖以下场景:

  • MySQL 模式:JSON、XML、时间及无符号类型的读写与参数绑定,会话设置、CTE 参数顺序及 UPSERT。
  • Oracle 模式:JSON 条件、HAVING 别名解析、存储过程调用、模式识别、生成主键回读及参数化 CRUD。
  • SQL Server 模式:日期与 JSON 处理、分页聚合、JOIN、权限校验、特殊类型读写及事务回滚。

上述已执行的定向实库验证均通过。

后续将继续补充边界场景测试;如发现兼容性问题,会补充相应修复和回归用例。

整理开发分支 3cc0a1c 相对上游 main 的变更,保留模式识别、SQL 与 JDBC 适配及回归基线。

Refs APIJSON#868, APIJSON#855
(cherry picked from commit ef417ed84b1bbf4939c46e6898dc8572a784a386)
(cherry picked from commit cb69449d05c86a526bb845aadc8115416973bde4)
(cherry picked from commit 7a369df8fa940e4d17b281fc2bc3f31390f10bcd)
(cherry picked from commit d77cfa11f9462639c3b06bc9c278742ec160e4bf)
保留 DISTINCT 分页断言;单行聚合遵循上游 APIJSON#885,不再要求 OFFSET/FETCH。
@fuziran

fuziran commented Nov 20, 2026

Copy link
Copy Markdown
Contributor Author

@TommyLemon 您好,本 PR 的 Maven 构建与测试已通过。目前 CI 失败发生在后续的 Update dependency graph 步骤,上传依赖快照时返回 403:Resource not accessible by integration。

看起来是 fork PR 的只读令牌无法向上游提交依赖快照,请帮忙确认此类 PR 是否应跳过该上传步骤。感谢审阅。

@TommyLemon TommyLemon left a comment •

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

save first and review AbstractSQLConfig later

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants