Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Peningkatan versi utama Amazon DocumentDB di tempat
Amazon DocumentDB membuat versi baru dari mesin database umumnya hanya tersedia setelah pengujian ekstensif. Anda dapat memilih bagaimana dan kapan untuk meng-upgrade cluster Amazon DocumentDB Anda ke versi baru.
Saat ini, Amazon DocumentDB mendukung tiga versi utama: Amazon DocumentDB 3.6, 4.0, dan 5.0. Anda dapat melakukan upgrade versi utama (MVU) di tempat dari database Anda sambil menjaga titik akhir, penyimpanan, dan tag cluster yang sama dan dapat terus menggunakan aplikasi Anda tanpa modifikasi apa pun. Fitur ini tersedia secara gratis di semua wilayah di mana Amazon DocumentDB 5.0 tersedia.
penting
Cluster Amazon DocumentDB Anda tidak akan tersedia selama upgrade versi utama di tempat dan cluster Anda akan mengalami beberapa reboot. Upgrade downtime dapat bervariasi dari cluster ke cluster tergantung pada jumlah koleksi, indeks, database, dan instance. Kami merekomendasikan untuk melakukan peningkatan selama jendela pemeliharaan Anda atau selama jam pemanfaatan rendah. Setelah klaster Anda ditingkatkan, Anda tidak dapat menurunkan versi klaster ke versi sebelumnya, tetapi Anda dapat memilih untuk mengembalikan snapshot pra-upgrade ke cluster baru.
Topik
Prasyarat dan batasan MVU
Berikut ini adalah prasyarat dan batasan untuk peningkatan versi utama di tempat yang mungkin perlu Anda pahami dan ditindaklanjuti sebelum melakukan peningkatan:
Jenis Instans - Amazon DocumentDB 4.0/5.0 tidak mendukung instans r4.*. Untuk melanjutkan dengan upgrade versi utama di tempat, ubah instance r4.* ke instance r5.*. Untuk informasi selengkapnya, lihat Memodifikasi instance Amazon DocumentDB. Silakan merujuk ke Kelas instance yang didukung berdasarkan wilayah untuk instance yang didukung berdasarkan versi mesin Amazon DocumentDB.
Instans OS patch — Upgrade versi utama di tempat membutuhkan patch sistem operasi (OS) terbaru untuk melanjutkan. Harap terapkan tindakan pemeliharaan OS yang tertunda pada instans sebelum melanjutkan dengan peningkatan di tempat. Untuk informasi selengkapnya, lihat Pembaruan sistem operasi Amazon DocumentDB.
catatan
Dalam beberapa situasi, jika Anda memiliki patch mesin tingkat cluster yang tertunda, patch OS instance tidak terlihat. Anda mungkin perlu menerapkan patch mesin tingkat cluster sebelum melanjutkan dengan menerapkan patch OS instance dan, selanjutnya, upgrade versi utama di tempat. Lihat Melakukan pembaruan tambalan ke versi mesin cluster.
Upgrade versi utama di tempat tersedia di semua wilayah di mana Amazon DocumentDB 5.0 tersedia.
-
Upgrade versi utama di tempat tidak didukung dengan Amazon DocumentDB 4.0 sebagai versi target.
-
Mulai di Amazon DocumentDB 4.0, “.” di nama pengguna tidak didukung. Jika Anda memutakhirkan dari Amazon DocumentDB 3.6 ke 5.0 dan memiliki nama pengguna yang berisi” . “, silakan buat ulang nama pengguna Anda tanpa” . “, sebelum melanjutkan dengan MVU di tempat.
Upgrade versi utama di tempat saat ini tidak didukung pada cluster global Amazon DocumentDB dan cluster elastis.
catatan
Untuk memutakhirkan kluster global Anda, hapus klaster sekunder Anda dari klaster global, ubah klaster primer menjadi kluster regional, lakukan peningkatan versi utama di tempat pada klaster regional (primer), lalu buat ulang klaster global dengan menambahkan cluster sekunder menggunakan nama yang sama untuk mempertahankan titik akhir yang sama seperti sebelumnya. Perhatikan bahwa Anda akan dikenakan biaya IO saat klaster utama yang ditingkatkan mereplikasi data ke cluster sekunder yang baru ditambahkan. Untuk langkah-langkah rinci tentang cara menghapus cluster sekunder dari cluster global sebelum menghapus, lihat. Menghapus klaster dari klaster global Amazon DocumentDB
-
Jika Anda memiliki sejumlah besar indeks (>3.000) yang beroperasi dalam instance kinerja burstable (misalnya t3.medium atau t4g.medium), Anda harus meningkatkan instance utama Anda ke instance yang lebih besar (misalnya, setidaknya r5.large) untuk melakukan peningkatan versi utama di tempat. Anda dapat memilih untuk menurunkan ukuran instans setelah peningkatan versi utama di tempat selesai. Lihat tabel di bawah untuk mengetahui jumlah maksimum indeks yang didukung pada jenis instans db.t3 dan db.t4g untuk peningkatan versi utama di tempat:
Instans Indeks maksimum yang didukung untuk MVU di tempat db.t4g.medium
3K
db.t3.medium
10K
Praktik terbaik untuk peningkatan versi utama di tempat
Topik
Uji peningkatan versi utama di tempat menggunakan cluster kloning
-
Untuk menguji peningkatan versi utama di tempat, sebaiknya gunakan fitur kloning cepat untuk membuat klon dari kluster target Anda. Anda tidak akan dikenakan biaya penyimpanan apa pun untuk menguji peningkatan versi utama di tempat pada volume kloning, kecuali jika Anda memodifikasi data apa pun di cluster. Untuk informasi lebih lanjut tentang klon volume, lihatMengkloning volume untuk cluster Amazon DocumentDB.
-
Untuk mendapatkan perkiraan yang lebih realistis tentang waktu yang dibutuhkan untuk menyelesaikan peningkatan versi utama di tempat, cocokkan jumlah instance cluster kloning dengan cluster yang ditargetkan.
-
Kami merekomendasikan untuk menguji sepenuhnya klaster Amazon DocumentDB 5.0 yang baru ditingkatkan untuk setiap perbedaan fungsional guna memastikan semuanya berfungsi seperti yang diharapkan.
Sebelum upgrade versi utama di tempat
-
Siapkan grup parameter cluster yang kompatibel dengan versi.
Gunakan grup parameter cluster default Amazon DocumentDB untuk versi engine baru atau buat grup parameter cluster kustom Anda sendiri untuk versi engine baru.
Jika Anda mengaitkan grup parameter klaster Amazon DocumentDB sebagai bagian dari permintaan pemutakhiran, pemutakhiran versi utama di tempat akan secara otomatis me-reboot klaster untuk menerapkan grup parameter baru.
-
Pastikan Anda telah memenuhi prasyarat untuk peningkatan versi utama di tempat seperti yang disebutkan di bagian Prasyarat dan batasan.
-
Buat snapshot manual.
Proses upgrade membuat snapshot dari cluster database Anda selama upgrade. Sangat disarankan untuk membuat snapshot manual Anda sendiri sebelum proses upgrade. Lihat Membuat snapshot cluster manual.
catatan
Snapshot otomatis yang dibuat oleh proses pemutakhiran tidak akan dihapus secara otomatis setelah pemutakhiran versi utama di tempat selesai. Cuplikan ini tidak akan dikenakan biaya apa pun selama berada dalam periode retensi. Anda dapat memilih untuk menghapus snapshot ini setelah Anda memverifikasi peningkatan klaster yang berhasil.
Snapshot ini dinamai sebagai
preupgrade-<name>-<version>-<timestamp>.
-
Periksa apakah Anda sudah menjadwalkan upgrade versi utama klaster Anda di tempat.
Jika Anda telah memodifikasi cluster dan memilih untuk menerapkannya di jendela pemeliharaan berikutnya, jadwal peningkatan versi utama di tempat tidak akan terlihat di konsol, tetapi Anda dapat melihatnya di CLI. Anda dapat menjalankan perintah berikut untuk memeriksa apakah upgrade versi utama di tempat sudah dijadwalkan:
aws docdb describe-db-cluster \ --region $REGION \ --db-cluster-identifier $CLUSTER_NAME "PendingModifiedValues": { "EngineVersion": "5.0.0" }, Lakukan beberapa proses kering menggunakan klon volume di lingkungan yang lebih rendah untuk menguji peningkatan versi utama pasca klaster di tempat pada rencana eksekusi dan perbedaan fungsional apa pun. Kami merekomendasikan kloning dengan jumlah dan ukuran instance yang sama untuk mendapatkan perkiraan waktu peningkatan versi utama yang lebih baik. Untuk informasi selengkapnya, lihat Mengkloning volume untuk cluster Amazon DocumentDB.
Jika langkah sebelumnya berhasil, lanjutkan dengan upgrade versi utama di tempat pada cluster produksi.
Selama upgrade versi utama di tempat
Anda dapat memantau kemajuan peningkatan versi utama di tempat dengan berlangganan acara pemeliharaan klaster. Saat pemutakhiran selesai, Anda akan menerima acara “Database cluster major version has been upgraded”. Ini dan peristiwa lain yang terjadi selama pemutakhiran muncul di bagian 'Acara dan Tag' pada halaman detail cluster di konsol Amazon DocumentDB. Status cluster kemudian berubah dari 'upgrade' menjadi 'tersedia'.
Dari CLI, Anda dapat menjalankan aws docdb create-event-subscription untuk membuat acara dan aws docdb describe-events memantau kemajuan. Anda juga dapat mengatur pemberitahuan acara untuk peristiwa di atas ke Amazon SNS sebagai target yang akan diberitahukan melalui email, pesan push, dan metode lainnya. Untuk informasi selengkapnya, lihat Berlangganan acara Amazon DocumentDB.
Pemutakhiran versi utama di tempat menghasilkan peristiwa berikut selama pemutakhiran:
<cluster-name><timestamp>Upgrade sedang berlangsung: Membuat snapshot pra-upgrade [preupgrade- -]
Upgrade sedang berlangsung: Volume kloning.
Upgrade sedang berlangsung: Upgrade penulis.
Upgrade sedang berlangsung: Meningkatkan pembaca.
Database cluster versi utama telah ditingkatkan.
Acara juga terlihat di konsol di bawah halaman Acara:
Di dalam AWS CLI, Anda dapat menggunakan perintah berikut untuk melacak kemajuan:
aws docdb describe-events --source-identifier $CLUSTER_NAME --source-type db-cluster { "Events": [ { "SourceIdentifier": "mycluster", "SourceType": "db-cluster", "Message": "Database cluster engine version upgrade started.", "EventCategories": [ "maintenance" ], "Date": "2023-07-11T23:20:32.444000+00:00", "SourceArn": "arn:aws:rds:us-east-1:xxxx:cluster:mycluster" } ] }
Setelah peningkatan versi utama di tempat
Untuk Amazon DocumentDB 3.6, tambahkan tag ke cluster untuk membedakan bahwa cluster telah ditingkatkan ke Amazon DocumentDB 5.0 dari Amazon DocumentDB 3.6 sebagai lawan dari cluster Amazon DocumentDB 5.0 yang baru dibuat. Lihat bagian tentang perbedaan antara klaster Amazon DocumentDB 5.0 yang ditingkatkan dan cluster Amazon DocumentDB 5.0 yang baru.
Ambil snapshot manual setelah MVU di tempat selesai jika Anda perlu mengembalikan ke status pasca-peningkatan. Proses snapshot otomatis akan dilanjutkan segera setelah peningkatan versi utama di tempat selesai. Cuplikan manual tidak akan dikenakan biaya apa pun selama berada dalam periode retensi.
Untuk menggunakan fitur baru yang terkait dengan Amazon DocumentDB 5.0, misalnya, enkripsi level bidang sisi klien, sebaiknya tingkatkan versi driver Anda ke versi API MongoDB 5.0. Untuk informasi selengkapnya, lihat Apa yang baru di Amazon DocumentDB 5.0 daftar fitur Amazon DocumentDB 5.0.
penting
Segera setelah melakukan upgrade versi utama (MVU) di tempat, klaster Amazon DocumentDB 5.0 Anda akan mengisi kembali metadata indeks, berdasarkan mana mesin database mengoptimalkan rencana eksekusi kueri. Kinerja kueri yang diharapkan pada cluster Amazon DocumentDB Anda akan dilanjutkan setelah proses perhitungan ulang metadata indeks selesai. Biasanya, proses ini selesai dalam beberapa menit tetapi dapat bertahan hingga dua jam tergantung pada jumlah indeks pada cluster Anda. Reboot langsung, failover, atau skala naik/turun instance penulis Anda setelah MVU di tempat, dapat mengganggu proses perhitungan metadata indeks pada cluster Anda. Setelah MVU di tempat selesai, sebaiknya lakukan perubahan tersebut setelah Anda mengamati performa kueri yang diharapkan di klaster Amazon DocumentDB 5.0.
Selain itu, setelah MVU di tempat selesai, data aliran perubahan yang tersedia akan dibatasi hingga 3 jam terakhir.
Silakan hubungi AWS dukungan jika Anda melihat penurunan kinerja sementara ini bertahan selama lebih dari dua jam setelah MVU di tempat.
Uji sepenuhnya klaster Amazon DocumentDB 5.0 yang ditingkatkan untuk memastikan semuanya berfungsi seperti yang diharapkan.
Melakukan upgrade versi utama di tempat
Perbedaan antara Amazon DocumentDB 3.6/4.0 hingga 5.0 cluster yang ditingkatkan dan cluster Amazon DocumentDB 5.0 baru
-
Upgrade versi utama di tempat mempertahankan indeks asli pada cluster yang ditingkatkan. Dengan Amazon DocumentDB 5.0, kami telah meningkatkan efisiensi keseluruhan pemeliharaan indeks dan proses pengumpulan sampah, terutama untuk indeks kardinalitas rendah. Sebagai praktik terbaik umum, kami sarankan untuk membuat ulang indeks Anda menggunakan perintah indeks ulang setelah MVU berhasil diselesaikan. Membuat ulang indeks bukanlah persyaratan dan akan melibatkan I/O tambahan. Untuk informasi lebih lanjut, lihat. Pemeliharaan indeks Amazon DocumentDB menggunakan reIndex
-
Perbandingan subdokumen untuk beberapa tipe data numerik:
-
Jika cluster dimigrasikan dari Amazon DocumentDB 3.6, ia akan mewarisi perilaku perbandingan subdokumen Amazon DocumentDB 3.6. Perbedaan fungsional terbatas pada tipe numerik (seperti Long, Double, Decimal128) dalam subdokumen. Misalnya,
{a: {b: {NumberLong(1)}}tidak sama{a: {b: 1}}di Amazon DocumentDB 3.6, sementara mereka dibandingkan sama di Amazon DocumentDB 4.0 dan setelahnya. -
Perilaku perbandingan subdokumen ini hanya ada di Amazon DocumentDB 3.6, dan di Amazon DocumentDB 5.0 cluster yang ditingkatkan dari versi 3.6 menggunakan upgrade versi utama di tempat. Ini tidak berlaku untuk cluster Amazon DocumentDB 5.0 yang baru dibuat.
-
catatan
Untuk daftar perbedaan fungsional antara Amazon DocumentDB 3.6/4.0 dan Amazon DocumentDB 5.0, lihat. Kompatibilitas Amazon DocumentDB dengan MongoDB
Memecahkan masalah upgrade versi utama di tempat
Jika terjadi kegagalan, upgrade versi utama di tempat akan mencoba rollback upgrade untuk mengasumsikan status operasional terakhir cluster sebelum upgrade dimulai. Rollback yang berhasil akan menghasilkan peristiwa: “Kluster database berada dalam keadaan yang tidak dapat ditingkatkan: cluster DocumentDB berada dalam keadaan di mana pemutakhiran versi utama tidak dapat diselesaikan dengan sukses.” Pada titik ini, Anda harus menghubungi tim AWS dukungan untuk memecahkan masalah dan mencoba kembali peningkatan versi. Anda dapat terus menggunakan beban kerja Anda seperti sebelumnya. Dalam skenario langka lainnya di mana peningkatan memakan waktu lebih lama dari yang diharapkan, hubungi tim AWS dukungan untuk mendapatkan bantuan.
Setelah MVU di tempat Anda berhasil diselesaikan, klaster yang ditingkatkan mungkin mengalami penurunan kinerja sementara dan pemanfaatan CPU yang tinggi untuk durasi waktu yang singkat, sementara proses penyegaran metadata indeks sedang berjalan. Jika Anda terus mengalami penurunan kinerja selama lebih dari 2 jam, silakan hubungi AWS dukungan.
