Debian 上 PostgreSQL 迁移步骤
一 准备与评估
- 明确迁移范围：是单个数据库、多个数据库，还是整库集群；是否包含大对象（BLOB/large objects）、扩展、外部数据包装器（FDW）、触发器、定时任务等。
- 版本与兼容性：尽量保持源与目标 PostgreSQL 主版本一致；若跨小版本或跨大版本，先评估兼容性，必要时在测试环境演练。
- 停机窗口与一致性：选择低峰时段；如要求零停机，考虑采用逻辑复制或物理复制/流复制方案，而非一次性导出导入。
- 网络与权限：确保目标服务器磁盘、内存、I/O 充足；准备好具有足够权限的数据库用户与操作系统账号；规划好备份文件传输方式（如 scp/rsync）。
- 安全合规：备份文件含敏感数据，传输与落盘需加密与访问控制；完成后验证备份可用与数据一致性。
二 方法一 逻辑迁移 pg_dump 与 pg_restore（通用、最稳妥）
- 安装工具（源与目标按需安装）：sudo apt update && sudo apt install postgresql-client（仅导出/导入）或 postgresql postgresql-contrib（完整安装）。
- 源库导出（自定义格式，含大对象，推荐）：sudo -u postgres pg_dump -Fc -b -v -f /path/to/mydb.dump mydb。
- 目标库准备：sudo -u postgres createdb mydb（如已存在可先 drop 或使用新名；必要时先创建同名的空库与扩展）。
- 目标库恢复：sudo -u postgres pg_restore -d mydb /path/to/mydb.dump。
- 校验：sudo -u postgres psql -d mydb -c “SELECT COUNT(*) FROM your_table;” 或 \dt、\dv 等对象检查。
- 适用场景：跨版本迁移、只迁部分库/表、云上/云下迁移、需要选择性恢复。
三 方法二 全量逻辑迁移 pg_dumpall 与 psql（整实例迁移）
- 源库全量导出：sudo -u postgres pg_dumpall -U postgres -f all.sql（包含角色、表空间、全局对象等）。
- 目标库导入：sudo -u postgres psql -f all.sql（目标端需先安装好对应版本的 PostgreSQL 服务）。
- 适用场景：需要一次性迁移所有数据库与全局对象；注意目标端版本兼容与对象冲突处理。
四 方法三 物理迁移与复制（大库、低停机）
- 物理复制/流复制（热备）：配置源库 wal_level=replica、max_wal_senders、wal_keep_segments 等，创建复制用户；目标库作为standby接入，待追平后切换为主或从，实现近零停机迁移。
- pg_basebackup 物理备份恢复：在目标端执行 pg_basebackup 拉取全量备份，配置 recovery.conf/standby.signal 与 restore_command 指向 WAL 归档，可做到时间点恢复（PITR）。
- 适用场景：TB 级大库、对停机敏感、需要持续同步与快速切换的生产系统。
五 校验与常见问题
- 校验清单：对象数量与大小（\dt+）、关键表行数、约束与索引、触发器/函数、扩展（\dx）、FDW/外部表、权限（\dp）、大对象（lo_* 函数抽样）、应用连通性与回归查询。
- 常见问题与处理：
- 版本不一致导致恢复失败：优先对齐版本；无法对齐时先在测试环境验证兼容性与 SQL 差异。
- 扩展缺失：在目标库先 CREATE EXTENSION。
- 权限/属主不一致：迁移后用 psql \dp 检查，必要时使用 ALTER/GRANT 补齐。
- 大对象丢失：导出时使用 -b 包含大对象；恢复后抽样校验。
- 字符集/时区差异：确认 client_encoding、TimeZone 与应用一致性。
- 网络中断/中断恢复：自定义格式支持断点续传（pg_restore -j 并发），大库建议分库/分表并行恢复。