Some checks failed
ci / build-test-parity (push) Has been cancelled
- 从工作区根 docs/(非 git,未版本化)合并全部文档进版本控制,消除文档两头分裂
- 新增 README(状态总览+模块完成度+全文档索引)、项目进度与路线-总览-2026-06-17(A兼容/B新功能+关键路径+待拍板决策)
- 被取代的冲突状态/审计快照归入 归档/;对最易误导的两份("16视图已交付"实现交付报告、06-13架构快照)加"已归档"横幅
- 现行权威:engineclass移植backlog(46视图) + 用户管理Delta移植(方法论/交接) + 组件设计体系 + 通用模板收口 + 客户沟通
- 诚实口径:纵向模块仅用户管理 parity,横向引擎地基较全,余 153 定制视图(47 framework+106 业务)多为通用页已产·delta 未移植
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
4.9 KiB
4.9 KiB
PG 9.4 → 15 升级 Runbook v1(P0' 演练产出)
2026-06-11 | 性质:P0' 阶段交付物(决策会红线 1:任何不可逆变更须有已验证恢复的备份/演练耗时/实测回退点/客户书面批准) 演练环境:客户库测试副本(192.168.20.68:5435,PG 9.4.26,库 65GB)→ 本地 PG 15.18 与 Flowable 升级分窗执行(决策会已拍板);客户生产执行排切流期停机窗口
一、兼容性扫描结论(2026-06-11 实测,全绿)
| 检查项 | 结果 | 影响 |
|---|---|---|
| WITH OIDS 表(PG12 起不支持) | 0 个 | 最大拦路虎不存在 |
| 废弃类型列(abstime/reltime/tinterval) | 0 个 | 无 |
| unknown 类型列 | 0 个 | 无 |
| 扩展 | plpgsql / uuid-ossp / adminpack | 前两个 PG15 原生支持;adminpack 弃用,目标库不装(确认无业务依赖后) |
| 库编码 | UTF8 | 无 |
| 对象规模 | 1,063 表 / 120 视图 / 4 物化视图 / 218 自定义函数 / 4 序列 | 见 schema 演练 |
二、schema 全量 dump/restore 演练(已通过)
- 工具口径:用 PG 15 的 pg_dump 拉 9.4(官方支持回溯到 9.2;不要用 9.4 旧版 pg_dump)
pg_dump -n eip3 --schema-only:35 秒(网络),82,013 行 DDL- 前置两步(缺则报 1,400+ 角色/扩展错):
- 目标库先建角色:
CREATE ROLE eip3; CREATE ROLE ceshi LOGIN;(或 dump 加--no-owner --no-privileges,推荐保留 owner 以保权限原貌) - 目标库先装扩展:
CREATE EXTENSION "uuid-ossp";(11 个默认值函数依赖 uuid_ns_url 等)
- 目标库先建角色:
- 前置就绪后 restore:0 错误,对象数与源库完全一致(1,063/120/4/218)
- 结论:DDL 层 9.4→15 完全兼容,218 个自定义函数与全部视图无语法断点
三、数据迁移耗时模型
吞吐实测(1.6GB 代表性大表 gb_prj_worker 含照片大列,2026-06-11):
- dump(网络口径,-Fc 单线程):205 秒,≈7.8MB/s;产物压缩到 1.1GB
- restore(本地盘,单线程,含索引重建):34 秒,≈47MB/s;行数对账 15,814=15,814 ✅
65GB 全量外推:
- 保守上界(网络口径单线程):dump ≈2.4h + restore ≈0.5h + ANALYZE/对账 ≈0.5h + 缓冲 50% ≈ 5 小时
- 预期口径(服务器本地 +
-Fd -j4并行,经验 5–10× 于网络单线程):dump 15–30min + restore 30–60min + ANALYZE ≈10min + 对账 ≈20min + 缓冲 ≈ 2–3 小时停机窗口 ⚠️ 生产执行必须服务器本地 dump(磁盘对磁盘);精确窗口以客户侧专用环境完整演练(→v2)为准
建议停机窗口公式:窗口 = final_dump + restore + ANALYZE + 验证对账 + 预留 50% 缓冲
可压缩窗口的手段(按收益排序):
pg_dump -Fd -j N(目录格式并行 dump)+pg_restore -j N(并行恢复)——9.4 作为源支持 -Fd 并行- 提前全量预迁 + 窗口内仅增量?9.4 无逻辑复制(PG10+ 才有),不可行;pglogical 9.4 插件理论可行但引入第三方风险,不建议——接受全量窗口
- 大表(gb_clockingin 8.4GB、act_hi_* 归档 5.3GB)评估「归档表先迁/不迁」:act_*_archive 属历史归档,与客户确认后可窗口外迁移
四、执行步骤(生产窗口)
| # | 步骤 | 回退点 |
|---|---|---|
| 0 | 客户书面批准 + 业务停写公告;Flowable 服务停止(分窗纪律:本窗口只动 PG) | — |
| 1 | 源库 CHECKPOINT 后物理冷备份(pg_basebackup 或文件级)——回退点 A:原库原样 |
全程可回 A |
| 2 | 服务器本地 pg_dump -Fd -j4 -n eip3(含 Flowable ACT_* 同库则一并) |
— |
| 3 | PG 15 实例(新数据目录/新端口):建角色 → 建扩展 → schema restore → pg_restore -j4 数据 |
失败→回 A,原库未动 |
| 4 | ANALYZE(必做,否则计划器裸奔);vacuumdb --analyze-in-stages 可加速首批查询 |
— |
| 5 | 行数对账:逐表 count 对比脚本(见附录);抽样业务校验(对拍框架 ParityCli 指向新库跑全库 discover) | 不符→回 A |
| 6 | 应用切数据源(eip4-platform 改连接串;老系统若仍在用,JDBC 驱动 9.4 era 连 15 需实测——演练待办) | 配置回切 |
| 7 | 观察期 ≥1 周后,原 9.4 实例只读保留 ≥1 个月再下线 | 数据回查 |
五、风险与待办
| 项 | 状态 |
|---|---|
| 老系统(JDK6/老 JDBC 驱动)连 PG15 兼容性 | 待实测——绞杀者并行期老系统也要连新库,旧驱动对 PG15 的 SCRAM 认证不支持(须 password_encryption=md5 过渡)⚠️ 关键 |
| 物化视图 4 个 | restore 后须 REFRESH MATERIALIZED VIEW(dump 不带数据) |
| 序列 currval | dump 自带 setval,对账时核对 4 个序列当前值 |
| 全量耗时实测 | 本 Runbook 为吞吐外推;客户侧专用窗口做一次完整带数据演练后升级为 v2 |
附录:行数对账脚本
-- 在源/目标各执行,diff 输出
SELECT relname, n_live_tup FROM pg_stat_user_tables WHERE schemaname='eip3' ORDER BY relname;
-- 精确口径(慢):逐表 count(*),用 ParityCli --discover 的 JDBC count 能力或脚本生成