View a markdown version of this page

Peningkatan versi utama Amazon DocumentDB di tempat - Amazon DocumentDB
Jalur peningkatan yang didukungPrasyaratPraktik terbaikApa yang berubah setelah memutakhirkan dari Amazon DocumentDB 5.0 ke 8.0Post-upgrade pertimbangan untuk cluster ditingkatkan dari 3.6 atau 4.0Melakukan upgradePemecahan masalah

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

Anda dapat melakukan upgrade versi utama (MVU) in-place 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 di mana Amazon DocumentDB tersedia.

penting

Cluster Anda tidak akan tersedia selama peningkatan dan akan mengalami beberapa reboot. Jangan terhubung ke, membaca dari, atau menulis ke cluster setelah memulai upgrade. Downtime bervariasi tergantung pada jumlah koleksi, indeks, database, dan instance. Kami merekomendasikan untuk melakukan peningkatan selama jendela pemeliharaan Anda 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.

Jalur peningkatan yang didukung

Versi sumber Versi target

Amazon DocumentDB 3.6

Amazon DocumentDB 5.0

Amazon DocumentDB 4.0

Amazon DocumentDB 5.0

Amazon DocumentDB 5.0

Amazon DocumentDB 8.0
catatan

In-place MVU tidak didukung untuk cluster global atau cluster elastis. Untuk memutakhirkan cluster global, hapus cluster sekunder, konversi primer ke cluster regional, lakukan 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

  • Jenis instans - Amazon DocumentDB 4.0+ tidak mendukung instans db.r4. Ubah db.r4.* instance apa pun ke db.r5.* instance atau yang lebih baru sebelum memutakhirkan. Lihat Memodifikasi instance Amazon DocumentDB dan Kelas instance 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 engine tingkat cluster yang tertunda dapat menyembunyikan patch OS instance. Terapkan tambalan mesin terlebih dahulu jika diperlukan. Lihat Melakukan pembaruan tambalan ke versi mesin cluster.

  • Batas indeks pada instans burstable (instans t-family) — Jika Anda memiliki lebih dari 3.000 indeks pada instans burstable, tingkatkan primer menjadi 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 - Sebaiknya siapkan grup parameter cluster khusus untuk versi target sebelum memutakhirkan. Jika 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 pemutakhiran membuat snapshot otomatis bernamapreupgrade-<name>-<version>-<timestamp>, tetapi kami sangat menyarankan untuk memiliki cadangan Anda sendiri. 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.

    Gambar: kotak navigasi Snapshots yang menunjukkan tabel snapshot yang dibuat sebelumnya.

Praktik terbaik

Sebelum upgrade - pengujian dengan klon

  1. Gunakan Mengkloning volume untuk cluster Amazon DocumentDB untuk membuat tiruan dari cluster Anda. Anda tidak akan dikenakan biaya penyimpanan kecuali Anda memodifikasi data pada klon.

  2. Cocokkan jumlah instance klon ke cluster target untuk perkiraan waktu yang realistis.

  3. Lakukan MVU pada klon dan uji sepenuhnya perbedaan fungsional.

  4. Periksa apakah upgrade sudah dijadwalkan dengan menjalankan describe-db-clustersdan 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"
},

  5. Jika pengujian berhasil, lanjutkan dengan upgrade pada cluster produksi Anda.

Selama upgrade

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 Peristiwa dan Tag pada halaman detail cluster di konsol Amazon DocumentDB. Status cluster kemudian berubah dari upgrading keavailable.

Peristiwa berikut dihasilkan selama peningkatan:

  1. Peningkatan versi utama mesin cluster basis data dimulai. Cluster tetap online.

  2. Persiapan peningkatan sedang berlangsung: Memulai prapecek peningkatan online.

  3. Persiapan peningkatan sedang berlangsung: Prakecek peningkatan online yang telah selesai.

  4. Mengambil cluster database offline sementara instance utama menyelesaikan patch/upgrade proses.

  5. Persiapan peningkatan sedang berlangsung: Memulai prapecek peningkatan offline.

  6. Persiapan peningkatan sedang berlangsung: Prakecek peningkatan offline yang diselesaikan.

  7. <version-to><timestamp>Upgrade sedang berlangsung: Membuat snapshot pra-upgrade [preupgrade- <cluster-name>- <version-from>-to- -].

  8. Upgrade sedang berlangsung: Volume kloning.

  9. Upgrade sedang berlangsung: Upgrade penulis.

  10. Upgrade sedang berlangsung: Meningkatkan pembaca.

  11. Versi mayor mesin klaster basis data telah ditingkatkan.

Peristiwa terlihat di konsol di bawah halaman Acara:

Gambar: kotak navigasi Acara yang menunjukkan tabel peristiwa peningkatan.

Dari AWS CLI, Anda dapat menjalankan aws docdb describe-eventsuntuk memantau kemajuan peningkatan. Untuk menerima pemberitahuan secara otomatis, gunakan aws docdb create-event-subscriptionuntuk 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 upgrade versi utama di tempat, klaster 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 dapat memakan waktu hingga dua jam tergantung pada jumlah indeks pada cluster Anda.

Jangan reboot, failover, atau skala instance penulis up/down Anda selama waktu ini, karena dapat mengganggu perhitungan ulang metadata indeks. Sebaiknya tunggu hingga Anda mengamati kinerja kueri yang diharapkan sebelum membuat perubahan tersebut.

Lacak kemajuan melalui peristiwa klaster berikut:

  • Post-upgrade status cluster: Proses penyegaran metadata indeks dimulai

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

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

  1. Ambil snapshot manual dari cluster yang ditingkatkan jika Anda perlu mengembalikan ke status pasca-peningkatan. Proses snapshot otomatis akan dilanjutkan segera setelah upgrade versi utama di tempat selesai.

  2. Cluster tag ditingkatkan dari 3.6. Tambahkan tag untuk membedakan cluster yang ditingkatkan dari 3.6. (lihatPost-upgrade pertimbangan untuk cluster ditingkatkan dari 3.6 atau 4.0).

  3. Perbarui driver Anda. Untuk menggunakan fitur baru (misalnya, pemeriksaan, 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.

  4. Uji secara menyeluruh. Validasi aplikasi Anda terhadap klaster yang ditingkatkan.

Apa yang berubah setelah memutakhirkan dari Amazon DocumentDB 5.0 ke 8.0

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

  • Pemeriksaan. Amazon DocumentDB 8.0 mendukung pemeriksaan. Setelah upgrade, koleksi baru dan indeksnya, dan indeks baru pada koleksi yang ada, telah mengaktifkan pemeriksaan 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 kustom, grup parameter default baru dibuat untuk Amazon DocumentDB 8.0 dengan Planner Versi 3 dipilih secara otomatis. Dengan perencana kueri versi 3, 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 kompresi mereka. Untuk memanfaatkan kompresi Zstd pada koleksi yang ada, Anda dapat memodifikasi pengaturan kompresi mereka. Untuk informasi lebih lanjut, lihat Dictionary-based kompresi.

  • Indeks membangun kembali. Jika Anda memutakhirkan dari Amazon DocumentDB 5.0 ke Amazon DocumentDB 8.0, tidak diperlukan rebuild indeks.

catatan

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

Post-upgrade pertimbangan untuk cluster ditingkatkan dari 3.6 atau 4.0

  • Indeks membangun 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, kami sarankan untuk membangun 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 dengan {a: {b: 1}} 3.6, tetapi mereka sama di 4.0 dan yang lebih baru. Perilaku ini memengaruhi klaster apa pun yang ditingkatkan dari 3.6.

Melakukan upgrade

Using the Konsol Manajemen AWS

  1. Masuk ke Konsol Manajemen AWSdan buka konsol Amazon DocumentDB.

  2. Di tabel Clusters, pilih cluster sumber, klik Tindakan, lalu Ubah.

    Gambar: kotak navigasi Cluster yang menampilkan daftar tautan cluster yang ada dan tautan instans yang sesuai.

  3. Dalam spesifikasi Cluster, pilih versi target (misalnya, 5.0.0 atau 8.0.0) dari dropdown versi Engine.

    Gambar: bagian Spesifikasi cluster dari kotak dialog Modify cluster yang menunjukkan bidang pengindentifikasi Cluster dan versi Engine.

  4. Dalam opsi Cluster, pilih grup parameter cluster Anda untuk versi mesin target. Anda dapat menggunakan default (misalnya, default.docdb5.0 atau default.docdb8.0) atau grup parameter khusus yang Anda buat.

    Gambar: bagian Opsi cluster dari kotak dialog Ubah cluster yang menunjukkan bidang grup parameter Cluster.

  5. Pilih Lanjutkan, pilih preferensi penjadwalan Anda (segera terapkan atau jendela pemeliharaan berikutnya), lalu pilih Ubah cluster.

    Gambar: kotak dialog Modify cluster yang menunjukkan ringkasan dan penjadwalan modifikasi untuk cluster yang dipilih.

  6. Pantau status cluster di tabel cluster saat berubah menjadi upgrade:

    Gambar: kotak navigasi Clusters menyoroti kolom Status untuk klaster yang sedang ditingkatkan.
Using the AWS CLI

Gunakan modify-db-clusterdengan --allow-major-version-upgrade bendera:

aws docdb modify-db-cluster \
  ‐‐db-cluster-identifier mydocdbcluster \
  ‐‐allow-major-version-upgrade \
  ‐‐engine-version 8.0.0 \
  ‐‐apply-immediately \
  ‐‐cluster-parameter-group mydocdbparametergroup \
  ‐‐region us-east-1

Ganti masing-masing placeholder dengan informasi cluster Anda.

Pemecahan masalah

  • Upgrade kegagalan dan rollback. Jika upgrade gagal, secara otomatis mencoba rollback. Rollback yang berhasil menghasilkan peristiwa: “Kluster basis data berada dalam keadaan yang tidak dapat ditingkatkan.” Cluster Anda kembali ke status pra-pemutakhiran dan Anda dapat terus menggunakannya. Hubungi AWS dukungan untuk memecahkan masalah sebelum mencoba kembali.

  • Post-upgrade kinerja. Degradasi kinerja sementara dan pemanfaatan CPU yang tinggi dapat terjadi saat penyegaran metadata indeks berjalan. Jika degradasi berlanjut lebih dari 3 jam, hubungi AWS dukungan.

Untuk bantuan tambahan, hubungi AWS Support.