Files
eip4-platform/docs/P0-PG升级/PG升级Runbook-v1.md
zhengwr 1b69f8b481
Some checks failed
ci / build-test-parity (push) Has been cancelled
docs: 统一项目文档进 eip4-platform/docs + 新增进度路线总览
- 从工作区根 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>
2026-06-17 14:53:29 +08:00

75 lines
4.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 能力或脚本生成
```