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 pelaksanaannya.

Tindakan Pencegahan

Persyaratan protokol: Untuk meningkatkan versi utama instans kluster sharded, instans tersebut harus menggunakan MongoDB Protocol.
Proses dan dampak upgrade:
- Restart otomatis: Upgrade dilakukan secara rolling dan secara otomatis me-restart instans dua hingga tiga kali. Disarankan untuk melakukan upgrade pada jam sepi serta 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 operasi tulis (write) mungkin mengalami penurunan signifikan.
  Catatan
  - Untuk upgrade multi-versi, misalnya dari v3.0 ke v4.2, sistem melakukan upgrade secara berurutan melalui setiap versi perantara. 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 bahwa 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 upgrade instans kluster sharded, balancer dinonaktifkan dan diaktifkan kembali setelah upgrade selesai.
Penurunan versi: Anda tidak dapat menurunkan versi utama setelah melakukan 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 upgrade: Durasi upgrade bergantung pada 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 upgrade ke versi yang berdekatan, proses upgrade memakan waktu beberapa menit, mirip dengan restart instans.

Jalur upgrade yang didukung

Anda dapat meningkatkan versi utama database di Konsol ApsaraDB for MongoDB. Namun, versi target yang tersedia bervariasi tergantung pada arsitektur instans, tipe instans, dan versi saat ini. Rinciannya 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 (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
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 jenis penyimpanan berbeda, pertama-tama buat instans dengan versi utama target, lalu gunakan Data Transmission Service (DTS) untuk migrasi data dari sumber ke instans baru tersebut.
Lihat topik berikut untuk instruksi migrasi data:

Tes kompatibilitas

Sebelum meningkatkan versi utama, lakukan tes kompatibilitas.

Tinjau catatan rilis untuk setiap versi utama dalam jalur upgrade 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 kode client yang telah diperbarui terhadap instans baru tersebut untuk memeriksa adanya masalah kompatibilitas.
  Jika muncul masalah kompatibilitas, gunakan pesan error untuk debugging dan modifikasi kode client Anda.
4. Setelah pengujian selesai, lakukan rilis instans baru.

Prosedur

Masuk ke Konsol ApsaraDB for MongoDB.
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.
Pada bagian Specification Information, arahkan kursor ke Upgrade Database Version dan klik versi utama target.
Pada kotak dialog Upgrade Database Version, klik Confirm.