PostgreSQL 16.2 → 16.14 小版本升级操作手册

项目

内容

当前运行版本

PostgreSQL 16.2（源码编译）

目标升级版本

PostgreSQL 16.14

统一安装路径

/usr/local/pgsql

数据目录（不改动）

/data/pgdata/

编译标准参数

--prefix=/usr/local/pgsql --with-ossp-uuid --with-openssl --with-system-tzdata=/usr/share/zoneinfo

升级类型

小版本原地覆盖升级（数据目录无需 initdb，兼容同主版本所有小版本）

适用系统

CentOS/Rocky/ 银河麒麟 V10、Ubuntu/Debian

前置要求

业务停机、tzdata 时区包升级、完整二进制 + 逻辑备份

# RHEL/CentOS/麒麟
yum upgrade -y tzdata
# Rocky8+/Fedora
dnf upgrade -y tzdata

# 验证升级后版本
rpm -q tzdata
# 修复系统时区软链接
ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime

# 查看二进制版本
/usr/local/pgsql/bin/psql --version
# 数据库内确认版本
su - postgres
psql -c "SELECT version();"

# RHEL系
yum install -y gcc gcc-c++ make bison flex readline-devel zlib-devel openssl-devel libicu-devel libuuid-devel
# Ubuntu系
apt install -y gcc g++ make bison flex libreadline-dev zlib1g-dev libssl-dev libicu-dev libuuid-dev

# 带时间戳备份
cp -r -a /usr/local/pgsql /usr/local/pgsql.bak_$(date +%Y%m%d_%H%M%S)
# 校验备份文件存在
ls -ld /usr/local/pgsql.bak_*

# 创建备份目录
mkdir -p /data/pg_backup
# 全库导出所有库、用户、表结构、数据
sudo -u postgres pg_dumpall > /data/pg_backup/pg_all_backup_$(date +%Y%m%d_%H%M%S).sql
# 校验备份文件生成、文件大小非0
ls -lh /data/pg_backup/pg_all_backup_*.sql

# 执行项目自定义定时备份脚本
./runBackup.sh

# 进入临时目录
cd /tmp
# 下载16.14源码
wget https://ftp.postgresql.org/pub/source/v16.14/postgresql-16.14.tar.gz
# 解压
tar -zxvf postgresql-16.14.tar.gz
cd postgresql-16.14

make distclean

关键：编译参数必须和原 16.2 完全相同，否则扩展、SSL、uuid 插件会失效

./configure \
--prefix=/usr/local/pgsql \
--with-ossp-uuid \
--with-openssl \
--with-system-tzdata=/usr/share/zoneinfo

# 多核并行编译，利用全部CPU核心
make -j$(nproc) world

# systemd方式
systemctl stop postgresql
# 原生pg_ctl方式备用
/usr/local/pgsql/bin/pg_ctl stop -D /data/pgdata/ -m fast

ps aux | grep postgres | grep -v grep

# 覆盖安装到原/usr/local/pgsql目录
make install-world

/usr/local/pgsql/bin/pg_ctl --version
# 预期输出：pg_ctl (PostgreSQL) 16.14
/usr/local/pgsql/bin/psql --version

# systemd管理
systemctl start postgresql
# 原生启动备用
/usr/local/pgsql/bin/pg_ctl start -D /data/pgdata/

# 日志存放于数据目录示例
tail -100 /data/pgdata/postgresql-*.log
# 自定义日志目录替换路径
tail -100 /var/log/pg16/postgresql-*.log

su - postgres

SELECT version();
-- 预期：PostgreSQL 16.14

SELECT extname,extversion FROM pg_extension;

\l

SELECT 1;
SELECT current_timestamp;
SELECT now();

sql
SHOW timezone;
SHOW log_timezone;

SELECT uuid_generate_v4();

systemctl status postgresql
# 正常状态：active (running)
systemctl enable postgresql

rm -rf /tmp/postgresql-16.14 /tmp/postgresql-16.14.tar.gz

systemctl stop postgresql
/usr/local/pgsql/bin/pg_ctl stop -D /data/pgdata/ -m fast

rm -rf /usr/local/pgsql

# 修改为你实际备份的时间戳目录
mv /usr/local/pgsql.bak_20260717_103000 /usr/local/pgsql

systemctl start postgresql
# 或
/usr/local/pgsql/bin/pg_ctl start -D /data/pgdata/

/usr/local/pgsql/bin/psql -c "SELECT version();"
# 应恢复为 PostgreSQL 16.2