Untuk mengatasi pelanggaran pemeriksaan pra-upgrade, ketidakcocokan ekstensi, dan error batas resource saat Anda melakukan upgrade versi utama di tempat di AlloyDB untuk PostgreSQL, terapkan perbaikan yang direkomendasikan untuk pesan error yang ditampilkan oleh operasi upgrade Anda. Untuk mengetahui langkah-langkah pemecahan masalah upgrade umum, lihat Memecahkan masalah upgrade versi utama yang diterapkan.
Error umum saat mengupgrade versi utama
Bagian berikut menjelaskan pesan error yang dapat terjadi selama upgrade versi utama dan cara mengatasinya.
Error: Database: database_name. extension_violation: DEPRECATED, action_required: DELETE_EXTENSION
Deskripsi: AlloyDB mendeteksi ekstensi yang tidak digunakan lagi. Error tersebut menunjukkan ekstensi mana yang menyebabkan error:
database_name. extension_violation: DEPRECATED_EXTENSION, action_required: DELETE_EXTENSION. Query format to delete the extensions: DROP EXTENSION {extension_name}; Violation list: [extensions]
Perbaikan yang disarankan: Hapus ekstensi. Format kueri untuk menghapus ekstensi adalah DROP EXTENSION {extension_name};.
Error: Database: database_name. extension_violation: INVALID_EXTENSION_VERSION, action_required: UPGRADE_EXTENSION
Deskripsi: AlloyDB mendeteksi versi ekstensi yang tidak valid.
Perbaikan yang direkomendasikan: Upgrade ekstensi. Format kueri untuk mengupgrade ekstensi adalah ALTER EXTENSION {extension_name} UPDATE TO {target_version};.
Error: Database: database_name contains pg_largeobject
Deskripsi: AlloyDB mendeteksi pg_largeobject.
Perbaikan yang direkomendasikan: Hapus pg_largeobject sebelum mengupgrade cluster AlloyDB.
ERROR: out of shared memory
Deskripsi: Jika instance tidak memiliki memori bersama yang cukup, Anda mungkin akan melihat pesan error ini. Error ini kemungkinan besar terjadi jika Anda memiliki lebih dari 10.000 tabel.
Perbaikan yang direkomendasikan: Sebelum memulai upgrade, tetapkan nilai flag
max_locks_per_transaction
menjadi sekitar dua kali lipat jumlah tabel dalam instance. Instance
dimulai ulang saat Anda mengubah nilai flag ini.
ERROR: Koneksi tidak memadai
Deskripsi: Jika instance tidak memiliki kapasitas koneksi yang cukup, Anda mungkin akan melihat pesan error ini.
Perbaikan yang direkomendasikan: Sebaiknya tingkatkan nilai flag
max_connections
dengan jumlah database dalam instance Anda. Saat Anda mengubah
nilai flag ini, instance akan dimulai ulang.
Pemeriksaan sebelum upgrade gagal
Deskripsi: Saat Anda mengupgrade cluster AlloyDB, upgrade Anda mungkin gagal karena pemeriksaan pra-upgrade. Detail tentang pelanggaran ada
dalam respons API dalam bentuk logs_url. Anda akan diarahkan ke halaman konsol Google Cloud tempat log berada.
Perbaikan yang direkomendasikan: Berdasarkan pesan error, lihat error lain yang tercantum sebelumnya dalam dokumen ini untuk menyelesaikan masalah tertentu.