# 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 能力或脚本生成 ```