Upgrade Versi Utama Database ApsaraDB for MongoDB - ApsaraDB for MongoDB

Topik ini menjelaskan jalur peningkatan versi utama yang didukung untuk instans ApsaraDB for MongoDB serta prosedur peningkatannya. Saat Anda melakukan peningkatan versi utama, sistem secara otomatis meningkatkan ke versi minor terbaru yang tersedia dalam versi utama tersebut.

Perhatian

Persyaratan protokol: Untuk meningkatkan versi utama instans kluster sharded, instans tersebut harus menggunakan MongoDB Protocol.
Proses dan dampak peningkatan:
- Restart otomatis: Peningkatan dilakukan secara rolling dan secara otomatis me-restart instans dua hingga tiga kali. Disarankan untuk melakukan peningkatan selama jam sepi dan memastikan aplikasi Anda memiliki mekanisme koneksi ulang.
- Dampak performa: Mulai dari MongoDB 5.0, writeConcern default berubah dari {w:1} menjadi {w:majority}. Jika Anda meningkatkan versi utama instans dari 4.4 ke 5.0, performa write mungkin mengalami penurunan signifikan.
  Catatan
  - Untuk peningkatan multi-versi, seperti dari v3.0 ke v4.2, sistem melakukan peningkatan secara berurutan melalui setiap versi antara. Koneksi akan terputus sementara setelah setiap peningkatan versi.
  - Disarankan agar aplikasi di lingkungan produksi terhubung ke database menggunakan Connection String URI.
    
    Penggunaan Connection String URI untuk terhubung ke instans memastikan node yang terhubung selalu merupakan node primary. Hal ini mencegah operasi baca dan tulis aplikasi Anda terpengaruh oleh failover. Untuk informasi lebih lanjut tentang cara terhubung ke database menggunakan Connection String URI, lihat Connect to a replica set instance atau Connect to a sharded cluster instance.
Status balancer: Selama peningkatan instans kluster sharded, balancer dinonaktifkan dan diaktifkan kembali setelah peningkatan selesai.
Penurunan versi: Anda tidak dapat menurunkan spesifikasi versi utama setelah peningkatan.
Backup dan pemulihan: Setelah Anda meningkatkan versi utama database, Anda tidak dapat memulihkan data ke instans ApsaraDB for MongoDB dari backup versi utama sebelumnya. Anda dapat mengunduh file backup dan memulihkan data tersebut ke database yang dikelola sendiri. Untuk informasi lebih lanjut tentang cara memulihkan data backup ke database yang dikelola sendiri, lihat Restore data from a cloud disk backup atau Restore data from a local disk backup.
Durasi peningkatan: Durasi peningkatan bergantung pada faktor-faktor seperti volume data, jumlah database dan tabel, serta rentang versi. Perkiraan berikut hanya sebagai referensi karena waktu aktual dapat bervariasi.
- Instans dengan cloud disk: Sekitar 15 menit.
- Instans dengan local disk: Untuk peningkatan ke versi yang berdekatan, proses memerlukan beberapa menit, mirip dengan restart instans.

Jalur peningkatan yang didukung

Anda dapat meningkatkan versi utama database di ApsaraDB for MongoDB console. Namun, versi target yang tersedia bervariasi berdasarkan arsitektur instans, tipe instans, dan versi saat ini. Detailnya adalah sebagai berikut:

Architecture	Instance type	Current major version	Available upgrade versions
Standalone architecture	General-purpose with cloud disk	MongoDB 4.0	No higher major version is available for upgrade.
Standalone architecture	General-purpose with cloud disk	MongoDB 3.4	In-place upgrade is not supported. To upgrade the major version, you can create a new instance and use it to replace the original instance.
Replica set architecture	General-purpose with cloud disk Dedicated with cloud disk	MongoDB 8.0	MongoDB 8.3
		MongoDB 7.0	MongoDB 8.0
		MongoDB 6.0	MongoDB 7.0
		MongoDB 5.0	MongoDB 6.0
		MongoDB 4.4	MongoDB 5.0 When you upgrade an instance from v4.4 to v5.0, the default writeConcern changes from `{w:1}` to `{w:majority}`. This may cause a decrease in write performance and an increase in write latency. Confirm this impact is acceptable before you upgrade.
	General-purpose with local disk Dedicated with local disk Dedicated Physical Server	MongoDB 4.2	In-place upgrade is not supported. To upgrade the major version, you can create a new instance and use it to replace the original instance.
		MongoDB 4.0	MongoDB 4.2
		MongoDB 3.4	MongoDB 4.0 MongoDB 4.2
		MongoDB 3.2
		MongoDB 3.0
Sharded cluster architecture	Dedicated with cloud disk	MongoDB 8.0	MongoDB 8.3 (Submit a ticket to apply)
		MongoDB 7.0	MongoDB 8.0
		MongoDB 6.0	MongoDB 7.0
		MongoDB 5.0	MongoDB 6.0
		MongoDB 4.4	MongoDB 5.0 When you upgrade an instance from v4.4 to v5.0, the default writeConcern changes from `{w:1}` to `{w:majority}`. This may cause a decrease in write performance and an increase in write latency. Confirm this impact is acceptable before you upgrade.
	General-purpose with local disk Dedicated with local disk Dedicated Physical Server	MongoDB 4.2	In-place upgrade is not supported. To upgrade the major version, you can create a new instance and use it to replace the original instance.
		MongoDB 4.0	MongoDB 4.2
		MongoDB 3.4	MongoDB 4.0 MongoDB 4.2
		MongoDB 3.2
		MongoDB 3.0

Jika Anda perlu meningkatkan versi utama lintas arsitektur atau tipe penyimpanan yang berbeda, pertama-tama buat instans dengan versi utama target, lalu gunakan Data Transmission Service (DTS) untuk migrasi data dari sumber ke instans baru.

Lihat topik-topik berikut untuk petunjuk migrasi data:

Tes kompatibilitas

Sebelum meningkatkan versi utama, lakukan tes kompatibilitas.

Tinjau catatan rilis untuk setiap versi utama dalam jalur peningkatan Anda dan perbarui kode client Anda untuk memastikan kompatibilitas.
(Opsional) Gunakan pemulihan data untuk menguji kompatibilitas versi utama.

Penting
Pemulihan data menimbulkan biaya tambahan.
1. Gunakan data restoration untuk membuat instans baru dengan versi utama yang sama seperti instans Anda saat ini.
2. Upgrade versi utama instans baru tersebut.
3. Uji client yang telah diperbarui terhadap instans baru untuk memeriksa adanya masalah kompatibilitas.
  
  Jika muncul masalah kompatibilitas, gunakan pesan error untuk debugging dan modifikasi kode client Anda.
4. Setelah pengujian selesai, rilis instans baru tersebut.

Prosedur

Masuk ke ApsaraDB for MongoDB console.
Di panel navigasi sebelah kiri, klik Replica Set Instances atau Sharded Cluster Instances sesuai arsitektur instans Anda.
Di pojok kiri atas halaman, pilih kelompok sumber daya dan wilayah tempat instans Anda berada.
Klik ID instans target, atau klik Manage di kolom Actions untuk instans tersebut.
Di bagian Specification Information, arahkan kursor ke Upgrade Database Version dan klik versi utama target.
Di kotak dialog Upgrade Database Version, klik Confirm.

Catatan

Setelah peningkatan selesai, jika konsol masih menampilkan bahwa peningkatan sedang berlangsung, refresh halaman browser Anda untuk melihat status terbaru.