pg_upgrade

PostgreSQL 大版本升级工具

补充说明

pg_upgrade 在停机窗口内把旧版本数据目录升级到新版本，避免逻辑导出导入。它只支持大版本升级，且新旧集群的架构、locale 等必须兼容。

常用示例

pg_upgrade \
  --old-bindir=/usr/lib/postgresql/15/bin \
  --new-bindir=/usr/lib/postgresql/16/bin \
  --old-datadir=/var/lib/pgsql/15/data \
  --new-datadir=/var/lib/pgsql/16/data \
  --check

pg_upgrade --old-bindir=... --new-bindir=... \
  --old-datadir=... --new-datadir=... --link --jobs=4

# 升级后更新统计信息
vacuumdb --all --analyze-in-stages

易错点与排错

• 必须先停旧集群；运行中执行会失败或损坏数据。
• 先跑 --check，它会检查扩展、路径、权限和版本兼容性。
• --link 通过硬链接复用文件，速度快但不可回退；需要保留旧集群时用 --copy。
• 新旧版本必须同架构、同 locale/编码；跨平台不能直接用。
• 扩展要提前安装新版本对应的包，否则 --check 会报缺失。
• 统计信息不会迁移；升级后要跑 ANALYZE。
• 升级前做完整物理备份；失败时能回到旧集群。
• 升级后检查连接串、端口、systemd 单元和备份脚本。

相关命令

• pg_dump / pg_restore — 逻辑迁移
• pg_ctl — 启停集群
• vacuumdb — 更新统计信息