Debian系統更新PostgreSQL版本的完整步驟

一、升級前準備（關鍵步驟）

1. 備份所有數據庫

升級前必須備份數據，防止操作失誤導致數據丟失。推薦使用pg_dumpall備份所有數據庫：

sudo -u postgres pg_dumpall -f /var/backups/postgresql_backup.sql

也可備份單個數據庫：

pg_dump -U your_username -d your_database_name -f /path/to/backup.sql

2. 更新系統包列表

確保系統包為最新狀態，避免依賴沖突：

sudo apt update && sudo apt upgrade -y

二、添加PostgreSQL官方APT倉庫（可選但推薦）

Debian官方倉庫的PostgreSQL版本可能較舊，添加官方倉庫可獲取最新穩定版：

1. 創建PGDG倉庫文件

echo "deb http://apt.postgresql.org/pub/repos/apt/ $(lsb_release -cs)-pgdg main" | sudo tee /etc/apt/sources.list.d/pgdg.list

2. 導入GPG密鑰

wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -

注意：Debian 11及以上版本可能需要使用gpg命令替代apt-key（如gpg --dearmor -o /usr/share/keyrings/pgdg-archive-keyring.gpg ACCC4CF8.asc）。

三、執行升級操作

1. 小版本升級（如13.x→13.y）

小版本升級無需遷移數據，直接通過APT安裝新版本即可：

sudo apt install postgresql-13  # 替換為目標小版本號
sudo systemctl restart postgresql

升級后驗證版本：

psql --version  # 應顯示新版本號

2. 大版本升級（如12→13）

大版本升級需使用pg_upgrade工具遷移數據，步驟更復雜：

（1）安裝新版本PostgreSQL

sudo apt install postgresql-13  # 替換為目標大版本號

（2）停止舊版本服務

sudo systemctl stop postgresql@12-main  # 替換為舊版本的主進程名

（3）運行pg_upgrade檢查兼容性

sudo -u postgres /usr/lib/postgresql/13/bin/pg_upgrade \
  --old-datadir=/var/lib/postgresql/12/main \
  --new-datadir=/var/lib/postgresql/13/main \
  --old-bindir=/usr/lib/postgresql/12/bin \
  --new-bindir=/usr/lib/postgresql/13/bin \
  --check

若輸出無錯誤，繼續執行升級（去掉--check參數）。

（4）執行實際升級

sudo -u postgres /usr/lib/postgresql/13/bin/pg_upgrade \
  --old-datadir=/var/lib/postgresql/12/main \
  --new-datadir=/var/lib/postgresql/13/main \
  --old-bindir=/usr/lib/postgresql/12/bin \
  --new-bindir=/usr/lib/postgresql/13/bin \
  --link  # 使用硬鏈接減少磁盤空間占用

（5）清理舊版本

升級完成后，刪除舊版本包和數據目錄（確認新版本運行正常后再執行）：

sudo apt remove postgresql-12
sudo rm -rf /var/lib/postgresql/12

四、驗證升級結果

1. 檢查PostgreSQL版本：

   psql -U postgres -c "SELECT version();"
   

2. 測試數據庫連接和基本操作（如創建表、插入數據），確保功能正常。

注意事項

• 版本兼容性：升級前查閱PostgreSQL官方發行說明，確認新版本與舊版本的兼容性（如SQL語法變化、擴展支持）。
• 依賴問題：若遇到依賴沖突，可使用sudo apt --fix-broken install修復。
• 回滾方案：若升級失敗，可通過備份數據恢復舊版本（重新安裝舊版本包并恢復數據）。