Tingkatkan versi mesin minor RDS PostgreSQL - ApsaraDB RDS

ApsaraDB RDS for PostgreSQL memungkinkan Anda meningkatkan versi mesin minor. Peningkatan ini menyediakan peningkatan performa, fitur baru, dan perbaikan keamanan untuk terus mengoptimalkan serta mengamankan layanan database Anda.

Untuk informasi lebih lanjut mengenai fitur-fitur versi mesin minor ApsaraDB RDS for PostgreSQL, lihat Rilis versi minor kernel AliPG (PostgreSQL 14 hingga 18).

Catatan penggunaan

Peningkatan versi mesin minor akan me-restart instans, yang menyebabkan gangguan koneksi selama sekitar 30 detik. Kami menyarankan agar Anda melakukan peningkatan ini pada jam sepi atau memastikan aplikasi Anda memiliki mekanisme koneksi ulang otomatis.
Anda tidak dapat menurunkan spesifikasi versi mesin minor setelah melakukan peningkatan.
Peningkatan versi mesin minor biasanya tidak menyebabkan masalah kompatibilitas. Namun, peningkatan ekstensi mungkin menyebabkannya. Jika peningkatan melibatkan ekstensi seperti GanosBase, kami menyarankan menggunakan fitur Pulihkan data PostgreSQL untuk membuat instans uji dan memverifikasi kompatibilitas ekstensi baru tersebut.
Perhatikan hal-hal berikut terkait peningkatan ekstensi:
- Jika instans Anda menggunakan ekstensi PostGIS atau GanosBase, Anda harus secara manual memperbarui ekstensi PostGIS atau GanosBase setelah memperbarui versi mesin minor. Untuk informasi lebih lanjut, lihat Tingkatkan ekstensi mesin spasial-temporal.
- Jika instans Anda menjalankan PostgreSQL 14 dengan versi mesin minor sebelum 20230330 dan menggunakan ekstensi TimescaleDB (versi 2.5.0 atau lebih lama), Anda harus memperbarui ekstensi tersebut setelah meningkatkan versi mesin minor ke 20230330 atau versi yang lebih baru. Untuk melakukannya, jalankan secara manual perintah ALTER EXTENSION timescaledb UPDATE;. Langkah ini diperlukan agar ekstensi TimescaleDB tetap dapat digunakan.

Lihat versi mesin minor

Anda dapat melihat versi mesin minor saat ini dari suatu instans dengan salah satu cara berikut:

Masuk ke Konsol ApsaraDB RDS. Versi tersebut tersedia di halaman Basic Information instans Anda.

Catatan
Metode ini hanya berlaku untuk instans cloud disk ApsaraDB RDS for PostgreSQL.
Hubungkan ke instans PostgreSQL target dan jalankan perintah show rds_release_date;.

Catatan
Metode ini berlaku untuk instans cloud disk maupun local disk ApsaraDB RDS for PostgreSQL.

Tingkatkan versi mesin minor secara manual

Tingkatkan instans local disk

Anda tidak dapat meningkatkan instans local disk secara manual. Untuk meningkatkannya, restart instans agar secara otomatis diperbarui ke versi mesin minor terbaru. Untuk informasi lebih lanjut, lihat Restart instans ApsaraDB RDS for PostgreSQL.

Catatan

Untuk instans primary yang memiliki instans hanya baca terlampir, restart terlebih dahulu setiap instans hanya baca, lalu restart instans primary. Merestart hanya instans primary tidak akan meningkatkan versi mesin minor dari instans hanya baca yang terlampir.

Tingkatkan instans cloud disk

Catatan

Untuk instans primary yang memiliki instans hanya baca terlampir, Anda dapat menggunakan salah satu metode peningkatan berikut:

Mulai peningkatan pada instans primary. Tindakan ini akan terlebih dahulu meningkatkan semua instans hanya baca yang terlampir secara bersamaan, lalu meningkatkan instans primary.
Untuk menghindari peningkatan simultan semua instans hanya baca, tingkatkan masing-masing instans hanya baca secara individual sebelum meningkatkan instans primary.

Buka halaman Instances. Di bilah navigasi atas, pilih wilayah tempat instans RDS berada. Lalu, temukan instans RDS tersebut dan klik ID instansnya.
Di bagian Configuration Information, klik Update Minor Engine Version.
Pada kotak dialog yang muncul, pilih versi dari daftar drop-down Latest Version, tentukan Update Time, lalu klik OK.

String Latest Version terdiri dari bagian-bagian berikut:
- rds: Instans tersebut adalah instans RDS.
- postgres: Mesin database-nya adalah PostgreSQL.
- 1200: Versi utama PostgreSQL adalah 12.
- 20220830: Versi mesin minor kernel AliPG. Untuk informasi lebih lanjut mengenai setiap versi mesin minor, lihat Rilis versi minor kernel AliPG (PostgreSQL 14 hingga 18).
- 12.11: Versi minor komunitas PostgreSQL.

Tingkatkan versi mesin minor secara otomatis

Peringatan

Peningkatan otomatis merupakan metode tambahan dan tidak menjamin bahwa semua instans langsung ditingkatkan ke versi mesin minor terbaru. Anda dapat melihat status versi mesin minor di halaman Basic Information instans Anda dan secara proaktif meningkatkan versi mesin minor untuk mengurangi potensi risiko yang terkait dengan versi lama. Jika Anda membatalkan tugas peningkatan yang diprakarsai sistem atau gagal meningkatkan ke versi stabil terbaru setelah menerima notifikasi di konsol, Anda bertanggung jawab atas gangguan bisnis atau kehilangan data yang mungkin terjadi. Untuk informasi lebih lanjut, lihat Ketentuan Layanan.

Saat Anda membeli instans ApsaraDB RDS for PostgreSQL dengan cloud disk, Minor Engine Version Update Policy diatur ke Automatic Upgrade secara default. Jika versi mesin minor Anda lebih lama daripada versi terbaru, sistem secara berkala menjadwalkan tugas O&M proaktif untuk meningkatkan versi mesin minor tersebut. Anda akan diberi tahu mengenai tugas-tugas ini melalui email, dan pesan internal. Peningkatan otomatis dilakukan dalam maintenance window yang Anda konfigurasi. Anda dapat mengubah waktu peningkatan di Event Management atau membatalkan tugas sebelum dimulai. Untuk informasi lebih lanjut, lihat Scheduled events.

Catatan

Fitur peningkatan versi mesin minor otomatis hanya tersedia untuk instans cloud disk.

Ubah pengaturan peningkatan otomatis

Buka halaman Instances. Di bilah navigasi atas, pilih wilayah tempat instans RDS berada. Lalu, temukan instans RDS tersebut dan klik ID instansnya.
Di halaman Basic Information, buka bagian Configuration Information dan lihat status Automated Update of Minor Engine Version.
Klik Settings di sebelah kanan Automated Update of Minor Engine Version.
Pada kotak dialog yang muncul, pilih Automatic Upgrade atau Manual Upgrade, lalu klik OK.

FAQ

Apa yang harus saya lakukan jika akses ke ekstensi PostGIS atau GanosBase gagal setelah peningkatan versi mesin minor?

Setelah Anda meningkatkan versi mesin minor, Anda juga harus secara manual memperbarui ekstensi PostGIS atau GanosBase. Untuk informasi lebih lanjut, lihat Tingkatkan ekstensi mesin spasial-temporal.

Masalah kompatibilitas PostGIS apa saja yang mungkin terjadi selama peningkatan versi mesin minor?

Tabel berikut menjelaskan perbedaan kompatibilitas tersebut.

Catatan

Masalah kompatibilitas berikut mungkin terjadi pada instans ApsaraDB RDS for PostgreSQL yang menjalankan versi mesin minor sebelum 20211031.

Versi ekstensi PostGIS

Hanya peningkatan mesin

Peningkatan mesin dan ekstensi

2.5.x

Fungsi-fungsi berikut dapat menyebabkan database crash:
- ST_ClusterKMeans
- ST_GeomFromKML
- ST_AsKML
Fungsi-fungsi berikut menghasilkan error:
- ST_Buffer
  
  Pesan error: Invalid buffer parameter: uad_segs (accept: 'endcap', 'join', 'mitre_limit', 'miter_limit', 'quad_segs' and 'side')
  
  Solusi: Ubah parameter quadsegs menjadi quad_segs.
- ST_Intersects
  
  Pesan error: ERROR: GetGenericCacheCollection: Could not find upper context
  
  Solusi: Tidak ada.
Fungsi-fungsi berikut dihapus dan tidak dapat digunakan lagi:
- ST_Force_2D
- ST_Locate_Along_Measure
- ST_Estimated_Extent
Nilai parameter atau sintaks fungsi-fungsi berikut berubah setelah peningkatan:
- ST_GeomFromGeoJSON: Setelah peningkatan, SRID=4326 ditentukan secara default.
- ST_AsGeoJSON: Parameter maxdecimaldigits diubah dari 16 menjadi 9.
- Sintaks MultiPoint berubah:
  - Sebelum peningkatan: MULTIPOINT(1 1,-1 1)
  - Setelah peningkatan: MULTIPOINT((1 1),(-1 1))

Fungsi-fungsi berikut dihapus dan tidak dapat digunakan lagi:
- ST_Force_2D
- ST_Locate_Along_Measure
- ST_Estimated_Extent
Nilai parameter atau sintaks fungsi-fungsi berikut berubah setelah peningkatan:
- ST_GeomFromGeoJSON: Setelah peningkatan, SRID=4326 ditentukan secara default.
- ST_AsGeoJSON: Parameter maxdecimaldigits diubah dari 16 menjadi 9.
- Sintaks MultiPoint berubah:
  - Sebelum peningkatan: MULTIPOINT(1 1,-1 1)
  - Setelah peningkatan: MULTIPOINT((1 1),(-1 1))

3.1.x

Fungsi berikut dapat menyebabkan database crash:
- ST_ClusterKMeans
Sintaks MultiPoint berubah:
- Sebelum peningkatan: MULTIPOINT(1 1,-1 1)
- Setelah peningkatan: MULTIPOINT((1 1),(-1 1))

Sintaks MultiPoint berubah:

Sebelum peningkatan: MULTIPOINT(1 1,-1 1)
Setelah peningkatan: MULTIPOINT((1 1),(-1 1))

Dokumen terkait

Jika layanan Anda sudah menggunakan ekstensi PostGIS atau GanosBase, Anda juga harus secara manual memperbarui ekstensi PostGIS atau GanosBase setelah meningkatkan versi mesin minor. Untuk petunjuknya, lihat Peningkatan ekstensi mesin spasial-temporal.
Untuk informasi lebih lanjut mengenai setiap versi mesin minor, lihat Rilis versi minor kernel AliPG (PostgreSQL 14 hingga 18).

Anda juga dapat menggunakan operasi API berikut untuk meningkatkan versi mesin minor:

API	Deskripsi
UpgradeDBInstanceEngineVersion	Menambahkan versi mesin minor suatu instans.
ModifyHASwitchConfig	Menetapkan kebijakan peningkatan versi mesin minor menjadi otomatis atau manual.