Melakukan upgrade versi utama

Pilih versi mayor yang diinginkan dari daftar target yang tersedia dari yang tercantum untuk versi Anda dalam tabel. Anda bisa mendapatkan daftar versi yang tepat yang tersedia di versi Anda saat ini dengan menggunakan AWS CLI. Wilayah AWS Untuk detailnya, lihat Mendapatkan daftar versi yang tersedia di Wilayah AWS.

Verifikasi apakah aplikasi Anda berfungsi seperti yang diharapkan saat deployment uji coba versi baru. Untuk informasi tentang proses lengkapnya, lihat Menguji peningkatan klaster DB produksi ke versi mayor baru.

Setelah memverifikasi bahwa aplikasi Anda berfungsi seperti yang diharapkan saat deployment uji coba, Anda dapat meningkatkan klaster. Untuk detailnya, lihat Meningkatkan mesin Aurora PostgreSQL ke versi mayor baru.

Siapkan grup parameter yang kompatibel dengan versi.

Jika menggunakan instans DB kustom atau grup parameter klaster DB, Anda dapat memilih dari dua opsi:

Jika Anda menautkan instans DB baru atau grup parameter klaster DB sebagai bagian dari permintaan peningkatan, pastikan untuk mem-boot ulang basis data setelah proses peningkatan selesai untuk menerapkan parameter. Jika instans DB perlu di-reboot untuk menerapkan perubahan grup parameter, status grup parameter instans akan menampilkan pending-reboot. Anda dapat melihat status grup parameter suatu instans di konsol atau menggunakan perintah CLI, seperti describe-db-instances ataudescribe-db-clusters.

Periksa database yang tidak valid dan lepaskan semua yang ada.

datconnlimitKolom dalam pg_database katalog mencakup nilai -2 untuk menandai sebagai tidak valid setiap database yang terputus selama operasi. DROP DATABASE Gunakan kueri berikut untuk memeriksa apakah ada database yang tidak valid.

SELECT
    datname
FROM
    pg_database
WHERE
    datconnlimit = - 2;

Jika query mengembalikan nama database, database ini tidak valid. Gunakan DROP DATABASE invalid_db_name pernyataan untuk menjatuhkan database yang tidak valid. Anda dapat menggunakan pernyataan dinamis berikut untuk menghapus semua database yang tidak valid.

SELECT
    'DROP DATABASE ' || quote_ident(datname) || ';'
FROM
    pg_database
WHERE
    datconnlimit = -2 \gexec

Periksa penggunaan yang tidak didukung:

Periksa basis data template1 dan template0.

Agar peningkatan berhasil, basis data template 1 dan template 0 harus ada dan harus tercantum sebagai template. Untuk melakukannya, gunakan perintah berikut:

SELECT datname, datistemplate FROM pg_database; 
                        
datname    | datistemplate
-----------+---------------
template0  | t
rdsadmin   | f
template1  | t
postgres   | f

Dalam output perintah, nilai datistemplate untuk basis data template1 dan template0 seharusnya t.

Hapus slot replikasi logis.

Proses peningkatan tidak dapat dilanjutkan jika klaster DB Aurora PostgreSQL menggunakan slot replikasi logis apa pun. Slot replikasi logis biasanya digunakan untuk tugas migrasi data jangka pendek, seperti migrasi data menggunakan AWS DMS atau untuk mereplikasi tabel dari database ke danau data, alat BI, atau target lainnya. Sebelum meningkatkan, pastikan Anda mengetahui tujuan dari setiap slot replikasi logis yang ada, dan konfirmasikan bahwa menghapusnya tidak akan jadi masalah. Anda dapat memeriksa slot replikasi logis menggunakan kueri berikut:

SELECT * FROM pg_replication_slots;

Jika slot replikasi logis masih digunakan, Anda tidak boleh menghapusnya, dan Anda tidak dapat melanjutkan dengan peningkatan. Namun, jika slot replikasi logis tidak diperlukan, Anda dapat menghapusnya menggunakan SQL berikut:

SELECT pg_drop_replication_slot(slot_name);

Skenario replikasi logis yang menggunakan ekstensi pglogical juga harus memiliki slot yang dijatuhkan dari simpul penerbit untuk peningkatan versi utama yang berhasil pada simpul tersebut. Namun, Anda dapat memulai ulang proses replikasi dari simpul pelanggan setelah peningkatan. Untuk informasi selengkapnya, lihat Membangun kembali replikasi logis setelah peningkatan besar.

Lakukan pencadangan.

Proses peningkatan membuat snapshot klaster DB dari klaster DB Anda selama peningkatan. Jika Anda juga ingin melakukan pencadangan manual sebelum proses peningkatan, lihat Membuat snapshot klaster DB untuk informasi selengkapnya.

Tingkatkan ekstensi tertentu ke versi terbaru yang tersedia sebelum melakukan peningkatan versi utama. Ekstensi yang akan diperbarui meliputi:

Jalankan perintah berikut untuk setiap ekstensi yang baru diinstal.

ALTER EXTENSION PostgreSQL-extension UPDATE TO 'new-version';

Untuk informasi selengkapnya, lihat Meningkatkan ekstensi PostgreSQL. Untuk mempelajari selengkapnya tentang cara meningkatkan PostGIS, lihat Langkah 6: Tingkatkan GIS ekstensi Post.

Jika Anda meningkatkan ke versi 11.x, buang ekstensi yang tidak didukung sebelum melakukan peningkatan versi utama. Ekstensi yang perlu dibuang meliputi:

Buang jenis data unknown, bergantung pada versi target Anda.

PostgreSQL versi 10 tidak mendukung jenis data unknown. Jika basis data versi 9.6 menggunakan jenis data unknown, tingkatkan ke versi 10 akan menampilkan pesan kesalahan seperti berikut.

Database instance is in a state that cannot be upgraded: PreUpgrade checks failed: 
The instance could not be upgraded because the 'unknown' data type is used in user tables. 
Please remove all usages of the 'unknown' data type and try again."

Untuk menemukan jenis data unknown di basis data Anda sehingga Anda dapat menghapus kolom tersebut atau mengubahnya ke jenis data yang didukung, gunakan kode SQL berikut untuk setiap basis data.

SELECT n.nspname, c.relname, a.attname
    FROM pg_catalog.pg_class c,
    pg_catalog.pg_namespace n,
    pg_catalog.pg_attribute a
    WHERE c.oid = a.attrelid AND NOT a.attisdropped AND
    a.atttypid = 'pg_catalog.unknown'::pg_catalog.regtype AND
    c.relkind IN ('r','m','c') AND
    c.relnamespace = n.oid AND
    n.nspname !~ '^pg_temp_' AND
    n.nspname !~ '^pg_toast_temp_' AND n.nspname NOT IN ('pg_catalog', 'information_schema');

Lakukan peningkatan dry-run.

Sebaiknya Anda menguji peningkatan versi utama pada duplikat basis data produksi sebelum mencoba peningkatan pada basis data produksi Anda. Anda dapat memantau rencana eksekusi pada instans pengujian duplikat untuk setiap kemungkinan regresi rencana eksekusi dan untuk mengevaluasi performanya. Untuk membuat instans pengujian duplikat, Anda dapat memulihkan basis data Anda dari snapshot terakhir atau mengkloning basis data Anda. Untuk informasi selengkapnya, lihat Memulihkan dari snapshot atau Mengkloning volume untuk klaster DB Amazon Aurora.

Untuk informasi selengkapnya, lihat Meningkatkan mesin Aurora PostgreSQL ke versi mayor baru.

Tingkatkan instans produksi Anda.

Jika peningkatan versi utama operasi dry-run berhasil, Anda seharusnya dapat meningkatkan basis data produksi dengan percaya diri. Untuk informasi selengkapnya, lihat Meningkatkan mesin Aurora PostgreSQL ke versi mayor baru.

Untuk informasi tentang peningkatan yang sedang berlangsung, Anda dapat menggunakan Amazon RDS untuk melihat dua log yang dibuat oleh utilitas pg_upgrade. Log tersebut adalah pg_upgrade_internal.log dan pg_upgrade_server.log. Amazon Aurora menambahkan stempel waktu ke nama file untuk log ini. Anda dapat melihat log ini sebagaimana Anda dapat melihat log lainnya. Untuk informasi selengkapnya, lihat Memantau log Amazon Aurora Amazon.

Meningkatkan ekstensi PostgreSQL. Proses peningkatan PostgreSQL tidak meningkatkan ekstensi PostgreSQL apa pun. Untuk informasi selengkapnya, lihat Meningkatkan ekstensi PostgreSQL.