資料庫就地升級主要版本時發生錯誤

本文說明在 AlloyDB for PostgreSQL 中執行資料庫就地升級主要版本時，可能會遇到的錯誤。還會提供修正建議。詳情請參閱「排解就地升級主要版本的問題」。

錯誤：資料庫：database_name。extension_violation：DEPRECATED，action_required：DELETE_EXTENSION

說明：AlloyDB 偵測到已淘汰的擴充功能。錯誤訊息會指出導致錯誤的擴充功能：

database_name. extension_violation: DEPRECATED_EXTENSION, action_required: DELETE_EXTENSION."+" Query format to delete the extensions: `DROP EXTENSION {extension_name}; Violation list: [extensions]

建議修正方式：刪除擴充功能。如要刪除擴充功能，請使用 DROP EXTENSION {extension_name}; 格式的查詢。

錯誤：資料庫：database_name。extension_violation：INVALID_EXTENSION_VERSION，action_required：UPGRADE_EXTENSION

說明：AlloyDB 偵測到無效的擴充功能版本。

建議修正方式：升級擴充功能。升級擴充功能的查詢格式為 ALTER EXTENSION {extension_name} UPDATE TO {target_version};。

錯誤：資料庫「database_name」包含 pg_largeobject

說明：AlloyDB 偵測到 pg_largeobject。

建議修正方式：升級 AlloyDB 叢集前，請先移除 pg_largeobject。

錯誤：共用記憶體不足

說明：如果執行個體的共用記憶體不足，您可能會看到這則錯誤訊息。如果資料表超過 10,000 個，就更有可能發生這個錯誤。

建議修正方式：開始升級前，請將 max_locks_per_transaction 旗標的值設為執行個體中表格數量的兩倍左右。變更此旗標的值時，執行個體會重新啟動。

錯誤：連線不足

說明：如果執行個體的連線容量不足，可能會看到這則錯誤訊息。

建議修正方式：建議您根據執行個體中的資料庫數量，增加 max_connections 標記值。變更此旗標的值時，執行個體會重新啟動。

升級前檢查失敗

說明：升級 AlloyDB 叢集時，升級前檢查可能會導致升級失敗。違規詳細資料會以 logs_url 形式顯示在 API 回應中。系統會將您導向至 Google Cloud 記錄檔所在的控制台頁面。

建議修正方式：根據錯誤訊息，參閱本文件稍早列出的其他錯誤，解決特定問題。

後續步驟