待審查的擴充功能與邏輯複製物件

在升級之前，請檢視以下項目：

延伸規格

• pg_repack
• old_snapshot
• wal2json
• anon
• PostGIS

複製槽

• Logical replication slots

應用程式依賴項 若您移除了應用程式所依賴的擴充功能或複製物件，請在繼續進行升級之前，先驗證您的資料流與應用程式行為。 此外，也請考量您的應用程式邏輯若依賴於 PostgreSQL 的特定功能，可能會造成的干擾。

pg_repack

請在升級前刪除 pg_repack ，並在升級後重新建立該資料庫。 pg_repack 使用特定版本的擴充套件，其客戶端與伺服器元件必須與 PostgreSQL 的主要版本相符。

DROP EXTENSION pg_repack;

僅當您的工作負載仍需要該擴充功能時，才應在升級後重新建立該擴充功能。

CREATE EXTENSION pg_repack;

old_snapshot

請在升級前刪除 old_snapshot。 請勿在升級至 PostgreSQL 18後重新建立該項目，因為該項目已不再受支援。

DROP EXTENSION old_snapshot;

wal2json 複製槽

若您使用 wal2json 進行邏輯解碼，則必須在升級前刪除所有相關的複製槽。 pg_upgrade 工具嚴格禁止在存在複製槽的情況下進行主要版本升級，並會拋出嚴重錯誤並中止升級。

升級前：

1. 確保所有待處理的 WAL 資料均已處理完畢。
2. 請停止使用該複製槽的應用程式。
3. 刪除複製槽：

SELECT pg_drop_replication_slot('your_slot_name');

升級完成後，您可以根據需要重新建立複製槽。 請注意，wal2json 並非透過 CREATE EXTENSION 安裝，而是透過資料庫參數（wal_level、max_replication_slots、max_wal_senders ）及資料表權限進行設定，這些設定並不會阻礙升級作業。

anon

請在升級前移除「anon」擴充功能，若升級後仍需使用，請重新啟用該擴充功能。 在解除 anon 的訂閱之前，還需執行其他步驟。

若已安裝 anon 擴充套件，請在執行升級前，依照以下步驟操作，並以管理員身分執行相關指令。

1. 移除所有遮罩規則（若已啟用）。

   SELECT anon.remove_masks_for_all_columns();
   

2. 停用遮罩角色（若任何角色被標記為「遮罩」，升級可能會失敗）。

   SECURITY LABEL FOR anon ON ROLE <role_name> IS NULL;
   

3. 移除帶有「cascade」選項的 anon 擴充套件。

   DROP EXTENSION anon CASCADE;
   

4. 如果「anon」擴充套件已安裝在同一執行個體內的多個資料庫中，請針對每個資料庫依循所述步驟操作。

5. 升級完成後，請重新啟用「anon」擴充功能，並根據需要重新套用遮罩規則。

強烈建議在刪除擴充功能之前和之後皆對資料進行驗證，以確保在執行升級之前，資料遮罩處理的一致性。

PostGIS

如果您使用的是 PostGIS,，請先升級 PostGIS，再升級 PostgreSQL。

SELECT postgis_extensions_upgrade();

請使用以下查詢來驗證「PostGIS」擴充套件的升級狀況。

SELECT postgis_full_version();

Logical replication slots

請在升級前刪除所有邏輯複製槽，並在升級後重新建立它們。 邏輯插槽與來源伺服器的狀態相關聯，應在升級後的執行個體上重新建立，並確保其狀態為乾淨狀態。

SELECT pg_drop_replication_slot('<slot_name>');

邏輯複製槽

請在升級前刪除所有邏輯複製槽，並在升級後重新建立它們。 邏輯複製槽與來源伺服器的狀態相關聯，必須在升級後的執行個體上重新建立。

SELECT pg_drop_replication_slot('<slot_name>');

開始之前

在開始升級之前，請先確認以下事項：

• 請透過使用者介面 (UI)、API、命令列介面 (CLI) 或 Terraform，確認您的部署是否支援版本升級。

  範例（CLI）：

  ibmcloud cdb capability-show versions postgresql
  

• 檢視預先核查要求。 此升級會在原始部署環境中執行， 若偵測到風險，則會被阻擋。 請確定下列項目：

  • 部署狀況良好
  • 至少有 10% 的可用磁碟空間
  • I/O 使用率低於 90%
  • 模式大小與物件數量均在支援範圍內
  • 已完成所需的擴充功能及邏輯複製槽清理作業

• 請參閱《 https://www.postgresql.org/docs/release/ 》，了解可能影響您應用程式的相容性變更。

• 不支援降級至較早的版本。

• 就地升級一旦開始，便無法取消。

• 在升級之前，請確保有最新的備份可用。

Gen2 始於《 PostgreSQL 》第 18 頁。 隨著新版本獲得支援，系統會陸續新增升級路徑。 關於較早版本（14–17），請參閱 /docs/databases-for-postgresql?topic=databases-for-postgresql-upgrading。

升級完成後，您的部署將運行 PostgreSQL 的新主要版本。 升級前的備份和 PITR 還原點屬於較早版本的時間軸，無法還原至已升級的版本中。

為了在新版本中維持還原及 PITR 功能，請在升級完成後立即進行備份。 此備份將成為未來還原作業的基準。

若升級失敗，仍可利用 PITR 將升級前的備份還原至新部署環境，以恢復至較早的版本。

疑難排解

若在成功升級後發生問題，且您需要還原至先前版本，請聯絡 IBM Cloud® 技術支援以獲取指引。 請避免在未經指導的情況下執行 PITR 或還原作業，因為這可能會使復原過程變得複雜。

只有在所有預檢均通過後，才會執行升級。 如果升級受阻，請確認：

• 叢集狀態（Patroni 狀態為穩定）
• 足夠的可用磁碟空間
• 可接受的磁碟 I/O 使用率
• 模式大小與物件數量限制

大型資料結構和龐大的物件數量可能會延長升級所需的時間。

如果升級嘗試持續失敗，請透過 https://cloud.ibm.com/login?redirect=%2Funifiedsupport%2Fsupportcenter 提交支援工單。

推廣與升級的模擬運作

若要評估主要版本升級的影響，請執行一次模擬測試。 模擬執行會模擬升級與提升的過程，並將結果記錄至資料庫日誌中。 透過「日誌分析」整合功能，存取並檢視您的資料庫日誌。 這可確保您目前正在運行的版本及其擴充套件，能夠成功升級至您預期的版本。

執行模擬測試時，必須將 skip_initial_backup 設定為 false``，並定義 version 。

該指令如下：

curl -X POST \
  https://api.{region}.databases.cloud.ibm.com/v5/ibm/deployments/{id}/remotes/promotion \
  -H 'Authorization: Bearer <>'  \
 -H 'Content-Type: application/json' \
 -d '{
    "promotion": {
        "version": "14",
        "skip_initial_backup": false,
        "dry_run": true
    }
}' \