ApsaraDB RDS：解讀RDS PostgreSQL大版本升級檢查報告

警告格式：總磁碟空間: {*} GB; 已使用磁碟: {*} GB; 已使用inode: {*}; bytes-per-nodes: {*}; 升級需要最少磁碟空間: {*} GB。

可能原因：對象數量過多，需要足夠大小的磁碟空間。

解決辦法：

• 對於藍綠部署，在配置升級參數時，新執行個體的儲存空間必須大於或等於進行升級所需的最小磁碟空間。

• 對於本地升級，在升級前應對源執行個體進行儲存空間的擴容，擴容後的儲存空間必須大於或等於進行升級所需的最小磁碟空間。詳情請參見變更配置。

警告格式：當前記憶體: {*} GB; 推薦記憶體: {*} GB; 最低記憶體: {*} GB。

可能原因：對象數量過多，需確保擁有足夠的記憶體，以最大程度地減少在升級過程中執行個體的唯讀時間。

解決辦法：

• 對於藍綠部署，在配置升級參數時，新執行個體規格中的記憶體必須大於或等於最低記憶體要求。

• 對於本地升級，如果執行個體規格小於推薦記憶體，需要在升級前對源執行個體進行升配。詳情請參見變更配置。

警告格式：執行個體存在複製槽訂閱端，為防止訂閱資料不一致，建議查看阿里雲協助文檔。

可能原因：執行個體中存在複製槽訂閱端，您可以通過執行select * from pg_subscription;進行查看。

解決辦法：參見升級資料庫大版本，進行處理。

警告格式：Sequence表總數：{0}，過多Sequence表會延長邏輯複製大版本升級的切換時間。

可能原因：執行個體中存在Sequence表，通過執行select * from pg_sequences; 可以查看所有資料庫中的Sequence表。

解決辦法：如果Sequence表數量過多，建議使用複製執行個體進行切換時間的測試，以確保切換時間符合需求。

錯誤格式：無效超級賬戶：{*}；無效賬戶：{*}; 請查看阿里雲協助文檔。

可能原因：存在冗餘的超級帳號或者存在異常的普通帳號。

解決辦法：

• 對於冗餘的超級帳號，請提工單聯絡售後服務刪除。

• 對於異常的普通帳號，請重設報錯帳號的密碼。

錯誤格式：pg_upgrade預檢查任務失敗, 需要查看[pg_upgrade錯誤記錄檔]以及[pg_upgrade相關檔案與報錯]。

可能原因：預檢查失敗。

解決辦法：請參照pg_upgrade錯誤記錄檔，解決日誌問題。

錯誤格式：在資料庫：{*}中的schema：pg_catalog中安裝了pg_crypto外掛程式，請查看阿里雲協助文檔。

可能原因：由於pgcrypto在pg_catalog中建立了僅在高版本中存在的函數，導致了大版本升級的失敗。

解決辦法：刪除每個資料庫中的pgcrypto外掛程式，然後在非pg_catalog schema中建立該外掛程式。

錯誤格式：零停機大版本升級最低小版本20250228。

可能原因：執行個體核心小版本過低。

解決辦法：升級核心小版本。

錯誤格式：外部表格所在庫：{0}。總共庫：{1}。

可能原因：存在外部表格。

解決辦法：刪除外部表格。

1. 在執行個體的每個資料庫中執行以下SQL，擷取外部表格的資訊。

   SELECT COUNT(*) AS count, relkind
   FROM pg_class WHERE relkind IN ('f') GROUP BY relkind;

2. 執行以下SQL語句刪除外部表格。

   DROP FOREIGN TABLE [ IF EXISTS ] name [ CASCADE | RESTRICT ];

更多資訊請參見社區文檔。

錯誤格式：沒有主鍵或者唯一鍵的表所在庫：{0}。總共庫：{1}。

可能原因：存在沒有主鍵或者唯一鍵的表。

解決辦法：為表增加主鍵或者唯一鍵。

1. 在執行個體的每個資料庫中執行以下SQL，擷取沒有主鍵或者唯一鍵的表資訊。

    SELECT COUNT(*) AS count
   FROM information_schema.tables t
   LEFT JOIN information_schema.table_constraints tc
       ON t.table_name = tc.table_name 
       AND t.table_schema = tc.table_schema
       AND (tc.constraint_type = 'PRIMARY KEY' OR tc.constraint_type = 'UNIQUE')
   JOIN pg_class c 
       ON t.table_name = c.relname
   JOIN pg_namespace ns 
       ON c.relnamespace = ns.oid 
       AND ns.nspname = t.table_schema
   WHERE t.table_type = 'BASE TABLE'
       AND tc.constraint_type IS NULL
       AND t.table_schema NOT IN ('pg_catalog', 'information_schema')
       AND c.relreplident != 'f';

2. 執行以下SQL，將目標表的REPLICA IDENTITY設定為FULL。

   ALTER TABLE name REPLICA IDENTITY FULL;

3. 執行以下SQL，為目標表增加主鍵或者唯一鍵。

   --主鍵約束
   ALTER TABLE name
       ADD CONSTRAINT constrain_name PRIMARY KEY (column_name);
   --唯一鍵約束
   ALTER TABLE name
       ADD CONSTRAINT constrain_name UNIQUE (column_name);

更多資訊請參見社區文檔。

錯誤格式：物化視圖所在庫：{0}。總共庫：{1}。

可能原因：存在物化視圖。

解決辦法：刪除物化視圖。

1. 在執行個體的每個資料庫中執行以下SQL，擷取物化視圖。

   SELECT COUNT(*) AS count, relkind
   FROM pg_class
   WHERE relkind IN ('m')
   GROUP BY relkind;

2. 執行以下SQL，刪除物化視圖。

   DROP MATERIALIZED VIEW IF EXISTS name;

錯誤格式：大對象所在庫：{0}。總共庫：{1}。

可能原因：存在大對象。

解決辦法：刪除大對象。

1. 在執行個體的每個資料庫中執行以下SQL，擷取大對象。

   SELECT COUNT(*) AS count
   FROM pg_largeobject_metadata;

2. 執行以下SQL，刪除大對象。

   SELECT lo_unlink(largeobject_oid);

錯誤格式：邏輯複製禁止外掛程式所在庫：{0}。總共庫：{1}。

可能原因：使用了當前禁止的以下四個外掛程式：'pg_partman'、'pg_cron'、'pg_active' 和 'pg_logical'。

解決辦法：臨時刪除不相容外掛程式。

1. 在執行個體的每個資料庫中執行以下SQL，查看是否安裝了不相容外掛程式。

   SELECT COUNT(*) AS count
   FROM pg_extension 
   WHERE extname IN ('pg_partman', 'pg_cron', 'pg_active', 'pglogical');

2. 臨時刪除不相容外掛程式。

   DROP EXTENSION extension_name;

錯誤格式：邏輯複製要求wal_level為logical，max_wal_sender以及max_replication_slots至少為{0}，執行個體wal_level為：{1}, max_wal_sender為：{2}, max_replication_slots為：{3}。

可能原因：三個參數的取值未能滿足需求。

解決辦法：修改參數值。請注意，可能需要重啟執行個體以使更改生效。詳情請參見設定執行個體參數。