Jalur peningkatan yang didukung Prasyarat Praktik terbaik Apa yang berubah setelah memutakhirkan dari Amazon DocumentDB 5.0 ke 8.0 Post-upgrade pertimbangan untuk cluster yang ditingkatkan dari 3.6 atau 4.0 Melakukan upgrade Pemecahan masalah

Amazon DocumentDB upgrade versi utama di tempat

Anda dapat melakukan peningkatan versi utama (MVU) di tempat dari cluster Amazon DocumentDB Anda sambil mempertahankan titik akhir, penyimpanan, dan tag yang sama. Aplikasi Anda terus bekerja tanpa modifikasi. Fitur ini tersedia tanpa biaya tambahan di semua Wilayah AWS tempat Amazon DocumentDB tersedia.

penting

Cluster Anda tidak tersedia selama pemutakhiran dan reboot beberapa kali. Jangan terhubung ke, membaca dari, atau menulis ke cluster setelah memulai peningkatan. Waktu henti bervariasi tergantung pada jumlah koleksi, indeks, database, dan instance. Lakukan peningkatan selama jendela pemeliharaan atau jam pemanfaatan rendah.

Setelah ditingkatkan, Anda tidak dapat menurunkan versi ke versi sebelumnya. Anda dapat mengembalikan snapshot pra-upgrade ke cluster baru jika diperlukan.

Topik

Jalur peningkatan yang didukung
Prasyarat
Praktik terbaik
Apa yang berubah setelah memutakhirkan dari Amazon DocumentDB 5.0 ke 8.0
Post-upgrade pertimbangan untuk cluster yang ditingkatkan dari 3.6 atau 4.0
Melakukan upgrade
Pemecahan masalah

Jalur peningkatan yang didukung

Tabel berikut mencantumkan setiap jalur peningkatan versi utama di tempat yang didukung. Anda dapat memilih versi minor yang diterbitkan pada mayor target sebagai versi mesin target.

Versi utama sumber	Target versi utama	Catatan
Dokumen AmazonDB 3.6	Amazon DocumentDB 5.0 (versi minor apa pun yang diterbitkan)	Lihat Post-upgrade pertimbangan untuk cluster yang ditingkatkan dari 3.6 atau 4.0 untuk pertimbangan pasca-peningkatan.
Dokumen AmazonDB 4.0	Amazon DocumentDB 5.0 (versi minor apa pun yang diterbitkan)	Lihat Post-upgrade pertimbangan untuk cluster yang ditingkatkan dari 3.6 atau 4.0 untuk pertimbangan pasca-peningkatan.
Amazon DocumentDB 5.0 (versi minor apa pun yang diterbitkan)	Amazon DocumentDB 8.0 (versi minor apa pun yang diterbitkan)	Lihat Apa yang berubah setelah memutakhirkan dari Amazon DocumentDB 5.0 ke 8.0 untuk perubahan fitur.

Untuk melihat versi minor yang tersedia di Wil AWS ayah Anda, gunakan AWS CLI perintahaws docdb describe-db-engine-versions. Untuk daftar versi minor yang dirilis, lihatCatatan rilis.

catatan

Setiap MVU dapat menargetkan versi minor yang diterbitkan pada mayor tujuan. Misalnya, upgrade dari Amazon DocumentDB 3.6 atau 4.0 dapat langsung menuju ke versi minor 5.0 terbaru yang diterbitkan; tidak ada persyaratan untuk terlebih dahulu meningkatkan ke 5.0.0 dan kemudian menerapkan peningkatan versi minor.

Untuk mencapai 8.0 dari 3.6 atau 4.0, lakukan dua MVU: pertama ke versi minor 5.0 pilihan Anda, kemudian ke versi minor 8.0 pilihan Anda. Tidak ada jalur MVU 3,6 → 8,0 atau 4,0 → 8,0 langsung.

catatan

In-place MVU tidak didukung untuk cluster global atau cluster elastis. Untuk meng-upgrade cluster global, hapus cluster sekunder, konversi cluster primer ke cluster regional, jalankan MVU, lalu buat ulang cluster global dengan menambahkan cluster sekunder menggunakan nama yang sama untuk mempertahankan titik akhir Anda. Anda akan dikenakan I/O biaya saat primer yang ditingkatkan mereplikasi data ke sekunder baru. Untuk langkah mendetail, lihat Menghapus klaster dari klaster global Amazon DocumentDB.

Prasyarat

penting

Tingkatkan instans yang dapat meledak sebelum memutakhirkan. Jika cluster Anda menggunakan tipe instans yang dapat meledak (misalnya, db.t3.medium ataudb.t4g.medium), tingkatkan skala instans utama setidaknya db.r5.large atau db.r6g.large sebelum memulai pemutakhiran. Instans burstable mungkin tidak memiliki CPU dan memori yang cukup untuk menyelesaikan proses peningkatan, yang dapat mengakibatkan kegagalan pemutakhiran dan ketidaktersediaan cluster yang diperluas. Anda dapat menurunkan skala kembali setelah peningkatan selesai.

Tingkatkan instans penulis tanpa server sebelum memutakhirkan. Jika cluster Anda memiliki instance penulis tanpa server, DCU maksimum di dalam ServerlessV2ScalingConfiguration harus disetel ke 3 atau lebih tinggi sebelum memulai pemutakhiran. Cluster dengan DCU maksimum di bawah 3 tidak dapat ditingkatkan karena mereka tidak memiliki CPU atau memori yang cukup untuk menyelesaikan peningkatan.

Periksa indeks sebagian Anda sebelum memutakhirkan (tingkatkan dari Amazon DocumentDB 5.0 ke 8.0). Sebelum memulai peningkatan, tinjau indeks paruh Anda untuk indeks partialFilterExpression yang menggunakan $type operator untuk mencocokkan jenis BSON tertentu: khususnya aliasbinData,bool,date,double,decimal,, dan array tipe, atau kode tipe numerik seperti. { "$type" : 1 } Indeks parSIAL seperti itu menyebabkan peningkatan gagal, meskipun indeks berfungsi normal untuk membaca dan menulis. Gunakan db.collection.getIndexes() untuk men partialFilterExpression injau indeks parSIAL Anda. Jatuhkan indeks parSIAL yang terpengaruh sebelum memulai peningkatan dan buat ulang setelah peningkatan selesai. Jika Anda tidak yakin apakah indeks terpengaruh, hubungi AWS dukungan sebelum memutakhirkan.

Jenis instans — Amazon DocumentDB 4.0+ tidak mendukung instans db.r4. Ubah db.r4.* instans apa pun ke db.r5.* instance atau yang lebih baru sebelum memutakhirkan. Lihat Memodifikasi instance Amazon DocumentDB dan Kelas instans yang didukung berdasarkan Wilayah.
Patch OS - Terapkan tindakan pemeliharaan OS yang tertunda pada semua instance sebelum memutakhirkan. Lihat Pembaruan sistem operasi Amazon DocumentDB.

catatan
Patch mesin tingkat cluster yang tertunda dapat menyembunyikan patch OS instance. Terapkan patch mesin terlebih dahulu jika diperlukan. Lihat Melakukan pembaruan patch ke versi mesin cluster.
Batas indeks pada instans burstable (instans t-family) — Jika Anda memiliki lebih dari 3.000 indeks pada instans burstable, tingkatkan indeks primer ke setidaknya db.r5.large sebelum memutakhirkan. Anda dapat menurunkan skala kembali setelah peningkatan selesai.

Instans Indeks maksimum untuk MVU

db.t4g.medium

3K

db.t3.medium

10K
Grup parameter — Siapkan grup parameter cluster khusus untuk versi target sebelum memutakhirkan. Jika salah satu tidak ditentukan, grup parameter default untuk versi target akan digunakan (misalnya, default.docdb5.0 ataudefault.docdb8.0).
Snapshot manual — Buat snapshot manual sebelum memutakhirkan. Proses peningkatan membuat snapshot otomatis bernamapreupgrade-<name>-<version>-<timestamp>, tetapi selalu buat cadangan Anda sendiri. Lihat Membuat snapshot cluster manual.

catatan
Snapshot otomatis yang dibuat oleh proses peningkatan tidak akan dihapus secara otomatis setelah peningkatan versi utama di tempat selesai. Snapshot ini tidak akan dikenakan biaya apa pun selama berada dalam periode retensi. Anda dapat memilih untuk menghapus snapshot ini setelah Anda memverifikasi keberhasilan peningkatan cluster Anda.

Instans	Indeks maksimum untuk MVU
db.t4g.medium	3K
db.t3.medium	10K

Praktik terbaik

Sebelum upgrade - pengujian dengan klon

Gunakan Mengkloning volume untuk cluster Amazon DocumentDB untuk membuat klon cluster Anda. Anda tidak akan dikenakan biaya penyimpanan kecuali Anda memodifikasi data pada klon.
Cocokkan jumlah instance klon dengan cluster target untuk perkiraan waktu yang realistis.
Lakukan MVU pada klon dan uji sepenuhnya untuk perbedaan fungsional.
Periksa apakah peningkatan sudah dijadwalkan dengan menjalankan describe-db-clusters dan mencariPendingModifiedValues.EngineVersion. Jika Anda telah memodifikasi cluster dan memilih untuk menerapkannya di jendela pemeliharaan berikutnya, jadwal tidak akan terlihat di konsol tetapi Anda dapat melihatnya di AWS CLI:
```
aws docdb describe-db-clusters \
  --region us-east-1 \
  --db-cluster-identifier mydocdbcluster
```
```
"PendingModifiedValues": {
    "EngineVersion": "5.0.0"
},
```
Jika pengujian berhasil, lanjutkan dengan peningkatan pada cluster produksi Anda.

Selama upgrade

Anda dapat memantau kemajuan peningkatan versi utama di tempat dengan berlangganan acara pemeliharaan cluster. Ketika peningkatan selesai, Anda akan menerima acara “Versi utama cluster database telah ditingkatkan”. 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 upgrading keavailable.

Peristiwa berikut dihasilkan selama pemutakhiran:

Pembaruan versi utama mesin cluster database dimulai. Cluster tetap online.
Persiapan peningkatan sedang berlangsung: Memulai prakontrol peningkatan online.
Persiapan peningkatan sedang berlangsung: Penyelesaikan pemeriksaan awal peningkatan online.
Mengambil cluster database offline sementara instance utama menyelesaikan patch/upgrade proses.
Persiapan peningkatan sedang berlangsung: Memulai prakontrol peningkatan offline.
Persiapan peningkatan sedang berlangsung: Penyelesaikan pemeriksaan awal peningkatan offline.
<version-to><timestamp>Upgrade sedang berlangsung: Membuat snapshot pra-upgrade [preupgrade- <cluster-name>- <version-from>-to- -].
Peningkatan sedang berlangsung: Volume kloning.
Peningkatan sedang berlangsung: Peningkatan penulis.
Upgrade sedang berlangsung: Meningkatkan pembaca.
Versi mayor mesin klaster basis data telah ditingkatkan.

Acara terlihat di konsol di bawah halaman Acara:

Gambar: kotak navigasi Acara yang menunjukkan tabel acara peningkatan.

Dari AWS CLI, Anda dapat menjalankan aws docdb describe-events untuk memantau kemajuan peningkatan. Untuk menerima pemberitahuan secara otomatis, gunakan aws docdb create-event-subscription untuk berlangganan acara dan mengarahkannya ke Amazon SNS untuk email, pesan push, atau metode pengiriman lainnya. Untuk informasi selengkapnya, lihat Berlangganan acara Amazon DocumentDB.


aws docdb describe-events 
  --source-identifier mydocdbcluster 
  --source-type db-cluster

Perintah tersebut mengembalikan output serupa dengan berikut ini:


{
    "Events": [
        {
            "SourceIdentifier": "mydocdbcluster",
            "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

Awas

Segera setelah peningkatan versi utama di tempat, cluster Amazon DocumentDB Anda mengisi kembali metadata indeks yang digunakan mesin database untuk mengoptimalkan rencana eksekusi kueri. Kinerja kueri kembali ke tingkat yang diharapkan setelah proses ini selesai. Biasanya selesai dalam beberapa menit tetapi bisa memakan waktu hingga dua jam tergantung pada jumlah indeks di cluster Anda.

Jangan melakukan reboot, failover, atau menskalakan instance penulis up/down Anda selama waktu ini, karena dapat mengganggu penghitungan ulang metadata indeks. Tunggu sampai Anda mengamati kinerja kueri yang diharapkan sebelum membuat perubahan tersebut.

Lacak kemajuan melalui peristiwa cluster berikut:

Post-upgrade status cluster: Proses penyegaran metadata indeks dimulai
Post-upgrade status cluster: Proses penyegaran metadata indeks selesai dalam X detik

Hu AWS bungi dukungan jika proses penyegaran metadata indeks belum selesai dalam waktu tiga jam, atau jika Anda terus mengalami masalah kinerja setelah proses selesai.

Ambil snapshot manual dari cluster yang ditingkatkan jika Anda perlu mengembalikan ke status pasca-pemutakhiran. Proses snapshot otomatis akan dilanjutkan segera setelah peningkatan versi utama di tempat selesai.
Cluster tag ditingkatkan dari 3.6. Tambahkan tag untuk membedakan cluster yang ditingkatkan dari 3.6. (lihatPost-upgrade pertimbangan untuk cluster yang ditingkatkan dari 3.6 atau 4.0).
Perbarui driver Anda. Untuk menggunakan fitur baru (misalnya, kolasi, tampilan, atau kompresi Zstd di 8.0), tingkatkan ke versi API MongoDB yang sesuai. Untuk informasi selengkapnya, lihat Apa yang baru di Amazon DocumentDB 8.0.
Uji secara menyeluruh. Validasi aplikasi Anda terhadap cluster yang ditingkatkan.

Apa yang berubah setelah memutakhirkan dari Amazon DocumentDB 5.0 ke 8.0

Setelah melakukan peningkatan versi utama dari Amazon DocumentDB 5.0 ke 8.0, fitur berikut diaktifkan atau diubah:

Kolasi. Amazon DocumentDB 8.0 mendukung kol asi. Setelah upgrade, koleksi baru dan indeksnya, dan indeks baru pada koleksi yang ada, akan mengaktifkan kolasi secara default.
Indeks teks. Indeks teks baru dibuat menggunakan Text Index V2, yang menggunakan parser pencarian teks yang diperbarui untuk meningkatkan kompatibilitas MongoDB. Indeks teks yang ada tidak terpengaruh.
Versi perencana kueri. Jika Anda tidak memiliki grup parameter khusus, grup parameter default baru dibuat untuk Amazon DocumentDB 8.0 dengan Planner Versi 3 dipilih secara otomatis. Dengan perencana kueri versi 3, Menggunakan tampilan di Amazon DocumentDB 8.0 tampilan juga tersedia.
Kompresi. Amazon DocumentDB 8.0 mendukung kompresi dokumen berbasis kamus menggunakan algoritma Zstd. Setelah upgrade, koleksi baru dibuat dengan kompresi Zstd diaktifkan secara default. Koleksi yang ada dari 5.0 mempertahankan pengaturan kompresinya. Untuk memanfaatkan kompresi Zstd pada koleksi yang ada, Anda dapat mengubah pengaturan kompresi mereka. Untuk informasi selengkapnya, lihat Mengelola kompresi berbasis kamus di Amazon DocumentDB 8.0.
Indeks dibangun kembali. Jika Anda memutakhirkan dari Amazon DocumentDB 5.0 ke Amazon DocumentDB 8.0, tidak diperlukan pembangunan kembali indeks.

penting

Amazon DocumentDB 8.0 memerlukan TLS 1.2 atau lebih tinggi. TLS 1.0 dan TLS 1.1 tidak lagi didukung.

catatan

Untuk daftar lengkap perbedaan fungsional, lihatKompatibilitas Amazon DocumentDB dengan MongoDB.

Post-upgrade pertimbangan untuk cluster yang ditingkatkan dari 3.6 atau 4.0

Indeks dibangun kembali. MVU mempertahankan indeks asli. Amazon DocumentDB 5.0 telah meningkatkan pemeliharaan indeks dan pengumpulan sampah, terutama untuk indeks kardinalitas rendah. Setelah memutakhirkan dari 3.6 atau 4.0, bangun kembali indeks Anda untuk memastikan kinerja kueri yang optimal (opsional, melibatkan tambahan I/O). Lihat Pemeliharaan indeks menggunakan ReIndex.
Perbandingan numerik subdokumen (hanya 3.6). Cluster yang ditingkatkan dari 3.6 mewarisi perilaku 3.6 di mana tipe numerik dalam subdokumen tidak dibandingkan antar tipe. Misalnya, {a: {b: NumberLong(1)}} tidak sama {a: {b: 1}} di 3,6, tetapi mereka sama di 4.0 dan yang lebih baru. Perilaku ini memengaruhi setiap cluster yang ditingkatkan dari 3.6.

Melakukan upgrade

Pemecahan masalah

Pre-upgrade periksa kegagalan. Sebelum pemutakhiran dimulai, Amazon DocumentDB menjalankan pemeriksaan validasi pra-upgrade. Berikut ini adalah penyebab umum kegagalan pra-pemeriksaan:
- Peningkatan tidak dapat dilanjutkan karena koleksi memiliki nama dengan 58 karakter atau lebih — Ganti nama koleksi yang terpengaruh menjadi nama yang lebih pendek sebelum mencoba lagi peningkatan.
- Pembaruan tidak dapat dilanjutkan karena jumlah indeks melebihi batas untuk jenis instans — Tingkatkan ke jenis instans yang lebih besar sebelum mencoba lagi peningkatan. Untuk batas indeks berdasarkan jenis instance, lihatPrasyarat.
Kegagalan upgrade dan rollback. Jika upgrade gagal, secara otomatis akan mencoba rollback. Rollback yang berhasil menghasilkan peristiwa: “Cluster database dalam keadaan yang tidak dapat ditingkatkan.” Cluster Anda kembali ke status pra-upgrade dan Anda dapat terus menggunakannya. Hubun AWS gi dukungan untuk memecahkan masalah sebelum mencoba kembali.
Post-upgrade kinerja. Penurunan kinerja sementara dan pemanfaatan CPU yang tinggi dapat terjadi saat refresh metadata indeks berjalan. Jika degradasi berlanjut lebih dari 3 jam, hubungi AWS dukungan.

Untuk bantuan tambahan, hubungi AWS Dukungan.

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Tanggal dukungan versi mesin

Memutakhirkan versi mesin minor