Ubuntu PostgreSQL版本升级攻略

Ubuntu PostgreSQL版本升级攻略

升级PostgreSQL是维护数据库的重要环节，需根据版本类型（小版本/大版本）选择合适方法，并严格遵循步骤以避免数据丢失。以下是详细操作指南：

一、升级前准备

1. 备份所有数据

升级前必须备份，确保数据可恢复。使用pg_dumpall导出所有数据库（包括角色、表空间等）：

sudo -u postgres pg_dumpall > /path/to/backup.sql

建议将备份文件存储到远程服务器或云存储，避免本地磁盘故障导致数据丢失。

2. 检查当前版本

确认当前PostgreSQL版本，判断升级路径（如12→13为小版本，14→15为大版本）：

sudo -u postgres psql -c "SELECT version();"

3. 确认兼容性

• 大版本升级（如14→15）：查阅PostgreSQL官方文档的“Release Notes”，确认新版本与当前版本的兼容性（如扩展、自定义函数等是否支持）。
• 小版本升级（如14.5→14.7）：通常无需额外检查，直接通过包管理器升级即可。

二、小版本升级（如14.5→14.7）

小版本升级通过apt包管理器直接完成，步骤简单且风险低：

1. 停止PostgreSQL服务：

   sudo systemctl stop postgresql
   

2. 更新软件包列表：

   sudo apt update
   

3. 升级PostgreSQL： 指定当前主版本号（如14），apt会自动升级到该主版本下的最新小版本：

   sudo apt install postgresql-14
   

4. 重启服务：

   sudo systemctl start postgresql
   

5. 验证版本：

   psql --version  # 或 sudo -u postgres psql -c "SELECT version();"
   

小版本升级无需数据迁移，升级后检查数据库功能是否正常即可。

三、大版本升级（如14.x→15.x）

大版本升级需更换数据库集群，推荐使用pg_upgrade工具（快速）或逻辑转储（安全），以下分别介绍：

方法一：使用pg_upgrade（推荐，快速）

pg_upgrade是PostgreSQL官方提供的升级工具，直接迁移数据文件，耗时短，但需满足版本兼容性（如14→15支持，10→12不支持）。

1. 添加官方仓库（若未添加）

若当前Ubuntu版本未包含目标大版本，需添加PostgreSQL官方APT仓库：

sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'
wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -
sudo apt update

2. 安装新版本PostgreSQL

安装目标大版本（如15），不覆盖旧版本：

sudo apt install postgresql-15

3. 停止旧版本服务

sudo systemctl stop postgresql

4. 初始化新版本集群

新版本会自动初始化集群，但需确认目录（如/var/lib/postgresql/15/main）是否存在。

5. 执行pg_upgrade检查与升级

• 检查兼容性（可选但推荐）：

  sudo -u postgres /usr/lib/postgresql/15/bin/pg_upgrade \
    -b /usr/lib/postgresql/14/bin \  # 旧版本二进制目录
    -B /usr/lib/postgresql/15/bin \  # 新版本二进制目录
    -d /var/lib/postgresql/14/main \ # 旧版本数据目录
    -D /var/lib/postgresql/15/main \ # 新版本数据目录
    --check
  

  若输出“Check successful”，则可继续。

• 执行升级：

  sudo -u postgres /usr/lib/postgresql/15/bin/pg_upgrade \
    -b /usr/lib/postgresql/14/bin \
    -B /usr/lib/postgresql/15/bin \
    -d /var/lib/postgresql/14/main \
    -D /var/lib/postgresql/15/main \
    -o '-c config_file=/etc/postgresql/14/main/postgresql.conf' \  # 旧版本配置文件路径
    -O '-c config_file=/etc/postgresql/15/main/postgresql.conf'     # 新版本配置文件路径
  

6. 更新统计信息

升级后需更新统计信息，优化查询性能：

sudo -u postgres /usr/lib/postgresql/15/bin/vacuumdb --all --analyze-in-stages

7. 启动新版本服务

sudo systemctl start postgresql@15-main  # 启动新版本
sudo systemctl stop postgresql@14-main   # 可选：停止旧版本（需确认新版本正常）

方法二：逻辑转储（安全，跨版本兼容）

若pg_upgrade不支持（如10→12），或需要跨平台迁移，可使用逻辑转储，步骤如下：

1. 导出旧数据库

sudo -u postgres pg_dumpall -f /path/to/backup.sql

2. 安装新版本PostgreSQL

同方法一的步骤2。

3. 初始化新版本集群

sudo /usr/lib/postgresql/15/bin/initdb -D /var/lib/postgresql/15/main/

4. 启动新版本服务

sudo systemctl start postgresql@15-main

5. 导入数据

sudo -u postgres psql -f /path/to/backup.sql postgres

6. 验证数据

sudo -u postgres psql -c "SELECT version();"

方法选择建议

• 优先使用pg_upgrade（快速，适合生产环境）；
• 若pg_upgrade不支持或需跨平台，使用逻辑转储（安全，适合复杂环境）。

四、升级后配置与清理

1. 配置文件迁移

若使用pg_upgrade，旧版本的postgresql.conf、pg_hba.conf会自动复制到新目录（如/etc/postgresql/15/main/）。需检查以下配置：

• 端口：若新旧版本并存，修改新版本的端口（如从5432改为5433）：

  sudo sed -i 's/port = 5432/port = 5433/' /etc/postgresql/15/main/postgresql.conf
  

• 认证方式：确保pg_hba.conf中的认证方式（如md5、scram-sha-256）符合需求，避免无法登录。

2. 启动/停止服务

• 启动新版本：

  sudo systemctl start postgresql@15-main
  

• 停止旧版本（可选）：

  sudo systemctl stop postgresql@14-main
  

3. 验证升级

psql -p 5433 -U postgres -c "SELECT version();"  # 替换为新版本端口

检查数据库功能（如创建表、查询数据）是否正常。

4. 清理旧版本

确认新版本运行稳定后，卸载旧版本软件包并删除旧集群：

sudo apt remove --purge postgresql-14 postgresql-server-dev-14  # 卸载旧版本
sudo rm -rf /etc/postgresql/14/ /var/lib/postgresql/14/           # 删除旧配置和数据

5. 重启服务（可选）

若停止了旧版本，可重启新版本服务：

sudo systemctl restart postgresql

五、常见问题解决

1. 权限问题

若pg_upgrade报错“permission denied”，需确保旧数据目录和新数据目录的权限正确：

sudo chown -R postgres:postgres /var/lib/postgresql/14/main/
sudo chown -R postgres:postgres /var/lib/postgresql/15/main/

2. 配置文件冲突

若新旧版本的postgresql.conf有冲突（如max_connections），需手动合并，优先保留新版本的配置。

3. 扩展兼容性

升级后，部分扩展（如postgis）可能需要重新安装：

sudo apt install postgis postgresql-15-postgis  # 示例：重新安装postgis

通过以上步骤，可顺利完成Ubuntu环境下PostgreSQL的版本升级。务必牢记：备份是升级的前提，选择合适的升级方法，并仔细检查每一步的操作结果。