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>
75 lines
4.9 KiB
Markdown
75 lines
4.9 KiB
Markdown
# 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+ 角色/扩展错):
|
||
1. 目标库先建角色:`CREATE ROLE eip3; CREATE ROLE ceshi LOGIN;`(或 dump 加 `--no-owner --no-privileges`,推荐保留 owner 以保权限原貌)
|
||
2. 目标库先装扩展:`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% 缓冲`
|
||
|
||
可压缩窗口的手段(按收益排序):
|
||
1. `pg_dump -Fd -j N`(目录格式并行 dump)+ `pg_restore -j N`(并行恢复)——9.4 作为源支持 -Fd 并行
|
||
2. 提前全量预迁 + 窗口内仅增量?9.4 无逻辑复制(PG10+ 才有),**不可行**;pglogical 9.4 插件理论可行但引入第三方风险,**不建议**——接受全量窗口
|
||
3. 大表(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 |
|
||
|
||
## 附录:行数对账脚本
|
||
|
||
```sql
|
||
-- 在源/目标各执行,diff 输出
|
||
SELECT relname, n_live_tup FROM pg_stat_user_tables WHERE schemaname='eip3' ORDER BY relname;
|
||
-- 精确口径(慢):逐表 count(*),用 ParityCli --discover 的 JDBC count 能力或脚本生成
|
||
```
|