国产数据库研发平台适配，是把研发平台从原有数据库迁移到国产数据库并稳定运行的一套工程动作。本文给出可执行的五步路径、角色与交付物对照表、一条业务链路的适配示例和验收核对清单，帮助负责部署或信创改造的团队把评估、改造、测试、切换各环节留下可核对的证据。
要点总览（TL;DR）
- 适配前先按 SQL 语句、事务、连接与驱动、字符集与排序、批量与分页五个层面盘点数据库依赖，把每个依赖点标注为必须改造、可配置解决或无需处理，范围清单不留待定项。
- 实施按环境准备、兼容性评估、改造与配置、测试验证、切换与回滚五步推进，每步留下输入、动作、输出与完成标志，改造变更分开提交便于定位问题。
- 角色上由平台研发负责代码与配置改造、DBA 负责数据库侧参数与性能诊断、测试负责回归与性能对比、运维负责切换与监控接入，执行与评审不宜由同一人承担。
- 验收以功能一致性、性能对比数据、数据完整性校验、备份恢复与回滚演练、监控告警与运维交接为核对项，备份恢复和回滚演练应在切换前完成。
- ONES 信创版已完成全栈信创适配，适配对象覆盖芯片、操作系统、数据库等核心模块，已适配的数据库包括达梦数据库；具体版本与认证清单需向厂商核实。
适配前先界定范围：哪些数据库特性必须核对
适配返工多数源于范围没界定清楚：改造到测试阶段才发现某段原生 SQL 用了国产数据库不支持的函数，或某个定时任务依赖特定的分页写法。动手前应先形成一份数据库特性核对清单，把平台与数据库的交互面逐项列出并给出判定结论。
研发平台与数据库的交互主要集中在五个层面，盘点时按这五层展开，避免遗漏：
- SQL 语句：查询、更新、联表、子查询、聚合函数的写法，尤其是平台代码中手写的原生 SQL。
- 事务：事务隔离级别设置、长事务、锁等待与死锁处理逻辑。
- 连接与驱动：JDBC/ODBC 驱动版本、连接池参数、连接超时与重连策略。
- 字符集与排序：库表字符集、排序规则对中文排序和大小写敏感比较的影响。
- 批量与分页：批量插入写法、分页语法（如 LIMIT/OFFSET 与 ROWNUM 的差异）、自增主键生成方式。
盘点的入口在代码与配置两侧。配置侧检查 ORM 框架的方言配置、数据源配置、连接池配置；代码侧检索原生 SQL、存储过程调用、数据库函数、定时任务脚本和报表统计语句。检索结果按“必须改造 / 可配置解决 / 无需处理”三类标注，并写明判定依据，例如“分页语法使用了 MySQL 的 LIMIT，目标库需改写”属于必须改造，“连接池最大连接数需按目标库上限调整”属于可配置项。
范围清单的完成标志是：每个依赖点都有明确结论和责任人，没有“待定”项进入改造阶段。清单本身也是后续测试用例和验收核对的输入。
核心操作步骤：从评估到切换的五步推进
适配按“环境准备—兼容性评估—改造与配置—测试验证—切换与回滚”五步推进，每一步都应有输入、动作、输出和完成标志，形成可追溯的记录。
| 步骤 | 输入 | 主要动作 | 输出 | 完成标志 |
|---|---|---|---|---|
| 一、环境准备 | 范围清单、目标数据库版本与部署方案 | 安装国产数据库，确定字符集与排序规则，创建平台专用账号并授予最小必要权限，打通网络与连接参数 | 可连通的环境说明、账号权限清单 | 平台能以测试账号连接数据库并执行基础读写 |
| 二、兼容性评估 | 范围清单、平台代码与配置 | 逐项比对 SQL 语法、函数、数据类型、事务与锁行为的差异，标注影响面 | 兼容性评估报告（差异项、影响模块、改造建议） | 所有差异项有结论，改造工作量可估算 |
| 三、改造与配置 | 评估报告 | 替换数据库驱动，调整连接池参数与 ORM 方言配置，改写不兼容 SQL，处理存储过程与定时任务 | 改造记录（改动点、改动人、验证方式） | 平台在目标库上可启动，核心接口可调通 |
| 四、测试验证 | 改造后的版本、原库性能基线 | 执行功能回归，对比关键接口响应时间与吞吐，覆盖并发、长事务、批量导入场景 | 测试报告（用例通过率、性能对比数据、缺陷清单） | 功能用例全部通过，性能在约定区间内，遗留缺陷有处置结论 |
| 五、切换与回滚 | 测试报告、切换方案、回滚预案 | 按灰度或停机窗口执行切换，切换后做数据一致性校验，设定回退触发条件并演练 | 切换记录、数据校验结果、回滚演练记录 | 切换后核心链路正常，校验一致，回滚路径可用 |
第三步的改造要控制单次变更范围：驱动替换、方言配置、SQL 改写分开提交，便于出问题时定位。第四步的性能对比应使用同一套压测脚本和数据集，在原库与目标库各跑一轮，否则数据不可比。第五步的回退触发条件要提前写清楚，例如“切换后 2 小时内出现数据写入失败或核心接口错误率超过阈值即回退”，避免临场判断。
适配过程会产生大量评估项、改造任务、测试缺陷和验收证据，这些内容需要按阶段跟踪状态。ONES 的工作项与文档管理可以把评估项登记为任务、把测试记录与验收结论沉淀为文档，让每一步的完成标志有据可查；ONES 信创版已完成全栈信创适配，适配对象覆盖芯片、操作系统、数据库等核心模块，已适配的数据库包括达梦数据库，可作为信创环境下研发平台选型时的参考，具体版本与认证清单需向厂商核实。
角色分工与各阶段交付物
适配工作需要平台研发、DBA、测试、运维、安全与合规共同参与。组织规模较小时角色可以合并，但执行与评审不宜由同一人承担，否则验收证据失去独立性。
| 阶段 | 责任人 | 评审人 | 交付物 |
|---|---|---|---|
| 范围界定 | 平台研发负责人 | DBA | 数据库特性核对清单 |
| 环境准备 | DBA | 运维 | 环境说明、账号权限清单 |
| 兼容性评估 | 平台研发 + DBA | 技术负责人 | 兼容性评估报告 |
| 改造与配置 | 平台研发 | DBA、技术负责人 | 改造记录 |
| 测试验证 | 测试工程师 | 平台研发、DBA | 测试报告、性能对比数据 |
| 切换与回滚 | 运维 | 技术负责人、安全与合规 | 切换方案、回滚预案、切换与演练记录 |
| 验收 | 项目经理或技术负责人 | 各角色代表 | 验收核对清单、遗留风险记录 |
职责边界上，DBA 负责数据库侧的版本、参数、权限与性能诊断，平台研发负责代码与配置改造，测试负责用例设计与回归执行，运维负责环境、切换操作与监控接入，安全与合规负责权限最小化、数据保护要求与上线合规审查。每个阶段的交付物应指定存放位置和更新责任人，评估报告与测试报告在评审通过后冻结版本，后续变更走记录追加，避免同一份文档出现多个互相矛盾的版本。
示例：一条核心业务链路的适配过程
以“工作项创建与列表查询”这条链路为例，说明前述步骤如何落地。该链路涉及插入工作项记录、生成自增编号、按条件分页查询列表，是研发平台中使用频率最高的操作之一。
评估阶段发现的差异主要有三处：一是原实现使用数据库自增主键，目标库的自增列语法与取值行为需要确认；二是列表查询的分页语句使用了原库特有的写法，需改写为目标库支持的语法；三是列表默认按创建时间倒序，涉及时间类型字段的精度与排序规则差异。三处差异分别标注为必须改造、必须改造、可配置验证。
改造阶段，平台研发替换驱动与方言配置，改写分页语句，DBA 确认自增列配置与时间字段精度，改造记录中逐条写明改动文件、改动内容和本地验证结果。测试阶段设计四类用例：单条创建成功、并发创建时编号不重复、分页查询结果与原库一致、大数据量下列表响应时间对比。性能对比使用同一数据集，记录原库与目标库的 P95 响应时间。
验收证据包括：功能用例执行记录、分页结果比对截图或导出数据、性能对比表、缺陷修复记录。这条链路的适配记录可以作为其他链路的模板，后续链路按同样格式补充，最终汇总为整体验收材料。
完成检查：适配是否真正达标的核对项
适配是否完成，按以下核对项逐条判断，全部满足并有记录才可认定达标：
- 功能一致性：核心业务链路的回归用例全部通过，边界场景（空值、超长字段、特殊字符、并发写入）有覆盖记录。
- 性能可接受：关键接口在原库与目标库上的对比数据在约定区间内，慢查询已识别并有处置结论。
- 数据完整性：切换前后数据量、关键字段校验和一致，迁移或同步过程有校验脚本与结果记录。
- 备份恢复：按目标库方式完成备份与恢复演练，恢复后的数据可用性经过验证。
- 回滚演练：回退触发条件明确，回滚操作实际演练过并记录耗时。
- 监控告警：数据库连接数、慢查询、锁等待、磁盘空间等指标已接入监控，告警阈值与通知对象已配置。
- 运维交接：运维文档包含连接参数、账号权限、备份策略、常见故障处理，交接有签收记录。
- 遗留风险：未闭环的问题登记为观察项，写明影响范围、观察期和责任人。
上述核对项中，备份恢复与回滚演练容易被跳过，但它们是上线后出问题时唯一的兜底手段，应在切换前完成而非切换后补做。观察期内的监控数据与问题记录，也是判断适配是否真正稳定的依据。
常见问题
适配范围清单里出现无法当场判定的依赖点，应该怎么处理？
无法当场判定的依赖点通常是数据库特有语法或行为差异，例如自增列取值方式、时间字段精度、锁等待行为。处理方式是把它转为一条待验证事项，指定责任人和验证方式，在兼容性评估阶段用目标库实测给出结论，再回填到清单中。清单进入改造阶段前应没有“待定”项，否则改造范围和工作量都无法估算。
测试阶段性能对比数据不可比，常见原因是什么？
最常见的原因是原库与目标库使用了不同的压测脚本、数据集规模或并发配置，导致响应时间与吞吐量无法横向比较。建议固定同一套脚本与数据集，在两套环境各跑一轮，并记录 P95 响应时间、错误率和资源占用。另外要确认两边的连接池参数、索引和统计信息处于可比状态，否则差异可能来自配置而非数据库本身。
切换窗口内发现数据校验不一致，回退的判断依据是什么？
回退触发条件应在切换方案中提前写清楚，例如核心表数据量差异超过约定比例、关键字段校验和不一致、核心接口错误率超过阈值。切换后先执行校验脚本，结果不满足条件即按预案回退，避免在窗口内反复排查导致业务中断时间延长。回退操作应在此前演练过并记录耗时，确保窗口内可以完成。
团队规模较小，角色合并后如何保证验收证据的独立性？
角色可以合并，例如平台研发兼做部分 DBA 工作，但执行与评审应尽量分开。可行做法是由技术负责人或项目经理担任评审人，对评估报告、测试报告和切换方案做签收；测试用例的执行记录与缺陷处置结论单独留存，不与被评审的改造记录混在同一份文档中。这样即使人员重叠，证据链仍可追溯。
ONES 信创版在国产数据库方面的适配情况如何？
根据官网公开信息，ONES 信创版已完成全栈信创适配，适配对象覆盖芯片、操作系统、数据库等核心模块，已适配的数据库包括达梦数据库，适配的 CPU 包括鲲鹏与飞腾，操作系统包括银河麒麟、麒麟信安、统信、OpenEuler 和龙蜥。页面仅列出部分适配对象，具体数据库版本、驱动要求与认证证书明细需向厂商核实，不宜依据页面列举推断其他数据库的适配情况。
