Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Memelihara Amazon DocumentDB
Amazon DocumentDB secara berkala melakukan dua jenis pemeliharaan:
+ ****Pemeliharaan cluster memperbarui mesin database. Pembaruan mesin membawa perbaikan keamanan, perbaikan bug, fitur baru, dan peningkatan mesin lainnya.
+ ****Pemeliharaan instans memperbarui sistem operasi (OS) pada instance.
Patch engine dan pembaruan OS menggunakan tiga kategori siklus hidup yang sama — * opsional*, * wajib*, dan * paksa * — dengan notifikasi yang sama dan perilaku penerapan untuk setiap kategori. Rilis mesin juga memiliki kategori keempat: versi * minor*, yang Anda tingkatkan secara manual. Kategorinya adalah:
+ **Opsional ** —berisi peningkatan non-kritis. Tidak ada tanggal aplikasi otomatis dan tidak ada pemberitahuan AHD; terapkan saat cocok untuk Anda. (Untuk pembaruan OS, Anda dapat berlangganan `RDS-EVENT-0230` untuk diberi tahu ketika tersedia.)
+ **Diperlukan ** —berisi keamanan dan perbaikan penting lainnya. Anda menerima pemberitahuan melalui Dasbor Health (AHD) dan email. Tindakan yang diperlukan diterapkan secara otomatis selama jendela pemeliharaan cluster atau instans setelahnya`AutoAppliedAfterDate`. Anda dapat menunda dengan mengubah jendela pemeliharaan sebelum tanggal tersebut.
+ **Dip ** aksa—perbaikan yang langka dan sangat kritis. Auto-applies di luar jendela pemeliharaan Anda setelahnya`ForcedApplyDate`. Amazon DocumentDB hanya menunjuk tindakan yang dipaksakan ketika tidak ada opsi lain yang tersedia.
+ **Versi minor ** (hanya rilis mesin) —rilis mesin bernomor di atas versi utama (misalnya,`5.0.1`). User-driven: Anda memutakhirkan dengan memodifikasi versi mesin cluster. Jangan pernah menerapkan secara otomatis; tidak ada pemberitahuan AHD. Versi minor tidak dipublikasikan untuk versi utama yang lebih awal dari 5.0.
Patch mesin dirilis ke dalam satu kategori (opsional, wajib, atau dipaksa) dan tetap di sana. Kemajuan pembaruan OS: sebagian besar dimulai sebagai opsional dan, jika tidak diterapkan, transisi ke yang diperlukan dan akhirnya dipaksa. Waktu yang tepat tergantung pada patch dan dipublikasikan dalam pemberitahuan AHD dan bidang tanggal yang dikembalikan oleh `describe-pending-maintenance-actions` (lihat[Terapkan tanggal](#db-instance-updates-apply-date)). Catatan Rilis Amazon DocumentDB [https://docs.aws.amazon.com/documentdb/latest/devguide/release-notes.html](https://docs.aws.amazon.com/documentdb/latest/devguide/release-notes.html) menggunakan nama kategori ini saat mengumumkan perubahan mesin.
Menerapkan patch mesin apa pun membuat cluster offline sebentar. Sisa topik ini membahas cara kerja jendela pemeliharaan, cara menemukan pekerjaan yang tertunda, cara menerapkan patch mesin dan versi minor, cara kerja pembaruan OS, dan penanganan khusus untuk cluster global.
**Topics**
+ [Tindakan pemeliharaan untuk Amazon DocumentDB](#maintenance-actions)
+ [Penomoran versi mesin](#engine-version-numbering)
+ [Mengelola jendela pemeliharaan Amazon DocumentDB](#maintenance-window)
+ [Pemberitahuan untuk patch mesin Amazon DocumentDB](#patch-notifications)
+ [Melihat tindakan pemeliharaan Amazon DocumentDB yang tertunda](#view-pending-maintenance)
+ [Pembaruan mesin Amazon DocumentDB](#db-instance-updates-apply)
+ [Peningkatan versi minor](#minor-version-upgrades)
+ [Pembaruan sistem operasi Amazon DocumentDB](#os-system-updates)
+ [User-initiated pembaruan](#user-initiated-updates)
+ [Penambalan klaster global](#global-clusters-patching)
## Tindakan pemeliharaan untuk Amazon DocumentDB
Tindakan pemeliharaan berikut berlaku untuk cluster Amazon DocumentDB:
+ `system-update`— Tingkatkan patch mesin untuk cluster Amazon DocumentDB. Untuk informasi selengkapnya, lihat [Pembaruan mesin Amazon DocumentDB](#db-instance-updates-apply).
+ `os-upgrade`— Perbarui sistem operasi semua instans DB di cluster Amazon DocumentDB, menggunakan peningkatan bergulir. Untuk informasi selengkapnya, lihat [Pembaruan sistem operasi Amazon DocumentDB](#os-system-updates).
Tindakan pemeliharaan berikut berlaku untuk instans Amazon DocumentDB:
+ `system-update`— Tingkatkan sistem operasi instans Amazon DocumentDB. Sebaiknya gunakan tindakan `os-upgrade` pemeliharaan tingkat cluster sebagai gantinya. Untuk informasi selengkapnya, lihat [Pembaruan sistem operasi Amazon DocumentDB](#os-system-updates).
## Penomoran versi mesin
Amazon DocumentDB menggunakan dua pengidentifikasi versi terpisah:
+ **Versi mesin ** —nomor tiga bagian dalam bentuk `{{major}}.{{major}}.{{minor}}` (misalnya, `5.0.0` atau`5.0.1`). Dua bagian pertama (`5.0`) adalah versi kompatibilitas MongoDB; bagian ketiga adalah versi minor, bertambah ketika Amazon DocumentDB menerbitkan rilis kecil yang berisi perbaikan bug dan perbaikan yang tidak merusak. Ini adalah versi yang Anda tentukan saat membuat atau memutakhirkan cluster.
+ **Versi patch engine ** —nomor tiga bagian terpisah dalam formulir `{{major}}.0.{{patch}}` (misalnya,`3.0.17983`) yang mengidentifikasi level patch yang diterapkan ke cluster Anda. Digit tengah selalu`0`. Versi patch berisi perbaikan keamanan dan stabilitas kritis.
Anda dapat menentukan versi mesin dari awalan versi patch engine, seperti yang ditunjukkan pada tabel berikut.
| Awalan versi patch mesin | Versi mesin Amazon DocumentDB |
| --- | --- |
| 1.0.{{x}} | 3.6 |
| 2.0.{{x}} | 4.0 |
| 3.0.{{x}} | 5.0 |
| 4.0.{{x}} | 8.0 |
Untuk memeriksa versi patch cluster Anda berjalan, sambungkan dan jalankan`db.runCommand({getEngineVersion: 1})`.
Untuk daftar versi patch engine yang dirilis dan apa yang masing-masing berisi, lihat[Catatan rilis](release-notes.md).
## Mengelola jendela pemeliharaan Amazon DocumentDB
Setiap cluster dan setiap instance memiliki jendela pemeliharaan mingguan 30 menit tersendiri—periode ketika modifikasi terjadwal dan tambalan perangkat lunak dijalankan. Sebagian besar acara selesai dalam 30 menit; yang lebih besar dapat berjalan lebih lama.
Jika Anda tidak memilih jendela saat membuat sumber daya, Amazon DocumentDB menetapkannya secara acak dalam blok harian 8 jam yang ditentukan untuk Wilayah, pada hari yang dipilih secara acak. Pilih jendela yang meminimalkan dampak pada aplikasi Anda—malam hari atau akhir pekan, misalnya.
Untuk peningkatan mesin database, Amazon DocumentDB menggunakan jendela cluster, bukan jendela instans individual.
Tabel berikut menunjukkan blok waktu default per Wilayah.
| Nama Wilayah | Region | Blok Waktu UTC |
| --- | --- | --- |
| AS Timur (Ohio) | us-east-2 | 03:00-11:00 |
| US East (Northern Virginia) | us-east-1 | 03:00-11:00 |
| AS Barat (Oregon) | us-west-2 | 06:00-14:00 |
| Africa (Cape Town) | af-south-1 | 03:00 — 11:00 |
| Asia Pasifik (Hong Kong) | ap-east-1 | 06:00-14:00 |
| Asia Pasifik (Hyderabad) | ap-south-2 | 06:30 — 14:30 |
| Asia Pasifik (Malaysia) | ap-southeast-5 | 13:00-21:00 |
| Asia Pasifik (Mumbai) | ap-south-1 | 06:00-14:00 |
| Asia Pacific (Osaka) | ap-northeast-3 | 12:00-20:00 |
| Asia Pasifik (Seoul) | ap-northeast-2 | 13:00-21:00 |
| Asia Pasifik (Singapura) | ap-southeast-1 | 14:00-22:00 |
| Asia Pasifik (Sydney) | ap-southeast-2 | 12:00-20:00 |
| Asia Pasifik (Jakarta) | ap-southeast-3 | 08:00-16:00 |
| Asia Pacific (Melbourne) | ap-southeast-4 | 11:00-19:00 |
| Asia Pasifik (Thailand) | ap-Southeast-7 | 15:00-23:00 |
| Asia Pasifik (Tokyo) | ap-northeast-1 | 13:00-21:00 |
| Kanada (Pusat) | ca-central-1 | 03:00-11:00 |
| Kanada Barat (Calgary) | ca-west-1 | 18:00-02:00 |
| Tiongkok (Beijing) | cn-north-1 | 06:00-14:00 |
| Tiongkok (Ningxia) | cn-northwest-1 | 06:00-14:00 |
| Eropa (Frankfurt) | eu-central-1 | 21:00-05:00 |
| Europe (Zurich) | eu-central-2 | 02:00-10:00 |
| Eropa (Irlandia) | eu-west-1 | 22:00-06:00 |
| Eropa (London) | eu-west-2 | 22:00-06:00 |
| Europe (Milan) | eu-south-1 | 02:00-10:00 |
| Eropa (Paris) | eu-west-3 | 23:59 - 07:29 |
| Eropa (Spanyol) | eu-south-2 | 02:00 — 10:00 |
| Eropa (Stockholm) | eu-north-1 | 04:00 — 12:00 |
| Meksiko (Tengah) | mx-sentral-1 | 03:00-11:00 |
| Timur Tengah (UAE) | me-central-1 | 05:00 — 13:00 |
| Amerika Selatan (Sao Paulo) | sa-east-1 | 00:00-08:00 |
| Israel (Tel Aviv) | il-central-1 | 04:00-12:00 |
| AWS GovCloud (US-East) | us-gov-east-1 | 17:00-01:00 |
| AWS GovCloud (US-West) | us-gov-west-1 | 06:00-14:00 |
### Mengubah jendela pemeliharaan Amazon DocumentDB
Pilih jendela lalu lintas terendah yang Anda bisa, dan sesuaikan seiring waktu saat pola lalu lintas Anda bergeser. Cluster atau instance tidak tersedia selama jendela hanya jika perubahan sistem—operasi penyimpanan skala atau perubahan kelas instance, misalnya—memerlukan pemadaman, dan hanya selama perubahan itu benar-benar diperlukan.
**Mengubah waktu pemeliharaan**
+ Untuk sebuah klaster, lihat [Memodifikasi cluster Amazon DocumentDB](db-cluster-modify.md).
+ Untuk sebuah instans, lihat [Memodifikasi instance Amazon DocumentDB](db-instance-modify.md).
## Pemberitahuan untuk patch mesin Amazon DocumentDB
Ketika patch * mesin yang * diperlukan tersedia di Wil AWS ayah, setiap AWS akun dengan cluster Amazon DocumentDB yang terpengaruh di Wilayah tersebut menerima pemberitahuan melalui Dasbor Health (AHD) dan melalui email (dikirim ke alamat pengguna root AWS akun). Satu pemberitahuan dikirimkan per versi mesin Amazon DocumentDB yang terpengaruh. Anda dapat menemukannya di bawah ** Perubahan terjadwal ** di AHD. Setiap notifikasi mencantumkan waktu ketersediaan patch, jadwal penerapan otomatis, cluster yang terpengaruh, dan catatan rilis.
Patch mesin yang diperlukan mengikuti satu waktu tunggu sekitar 30 hari. Saat patch tersedia di Wilayah Anda, Amazon DocumentDB mengirimkan pemberitahuan yang dijelaskan di atas. Pada titik itu, patch `AutoAppliedAfterDate` diatur ke sekitar 30 hari kemudian. Hingga tanggal tersebut, patch tetap tertunda: Anda dapat menerapkannya kapan saja, atau menundanya dengan memindahkan jendela pemeliharaan cluster Anda ke hari berikutnya. Pada atau setelah`AutoAppliedAfterDate`, patch diterapkan secara otomatis selama jendela pemeliharaan cluster berikutnya.
Misalnya, patch yang diperlukan yang tersedia pada 1 Juni 2026 memiliki `AutoAppliedAfterDate` tanggal sekitar 1 Juli 2026. Anda menerima pemberitahuan pada 1 Juni 2026, dan jika Anda tidak mengambil tindakan, patch akan diterapkan secara otomatis selama jendela pemeliharaan pertama cluster Anda pada atau setelah 1 Juli 2026.
Anda memiliki dua opsi setelah menerima pemberitahuan: menerapkan sendiri patch sebelum tanggal penerapan otomatis, atau tunggu hingga diterapkan secara otomatis selama jendela pemeliharaan yang akan datang (default). Untuk menerapkan sendiri, buka ** tab ** Maintenance & backup cluster dan cari entri jenis`system-update`.
**catatan**
**Status notifikasi ** di AHD tetap Berlangsung ** sampai ** Amazon DocumentDB merilis patch mesin lain dengan versi patch baru.
Setelah patch diterapkan, versi patch engine cluster diperbarui agar sesuai dengan versi dalam notifikasi. Verifikasi versi baru dengan menjalankan`db.runCommand({getEngineVersion: 1})`.
Patch opsional dan versi minor baru tidak menghasilkan pemberitahuan AHD atau email. Untuk melacaknya, tonton catatan [https://docs.aws.amazon.com/documentdb/latest/devguide/release-notes.html](https://docs.aws.amazon.com/documentdb/latest/devguide/release-notes.html) rilis Amazon DocumentDB.
Patch paksa (kategori paling langka, disediakan untuk perbaikan keamanan paling kritis) juga diumumkan melalui AHD dan email. Tidak seperti patch yang diperlukan, mereka berlaku di luar jendela pemeliharaan Anda, jadi contoh waktu penerapan otomatis di atas tidak berlaku.
### Bereaksi terhadap pemberitahuan patch secara terprogram
AWS Health terintegrasi dengan Amazon EventBridge, yang memungkinkan Anda membangun aplikasi berbasis peristiwa di lebih dari 20 target, termasuk AWS Lambda dan Amazon Simple Queue Service (SQS). Untuk bereaksi terhadap ketersediaan patch engine secara terprogram, konfigur EventBridge asikan terhadap peristiwa tersebut. `AWS_DOCDB_DB_PATCH_UPGRADE_MAINTENANCE_SCHEDULED` Dari sana Anda dapat menangkap data acara, meningkatkan acara tambahan, mengirim pemberitahuan push melalui AWS Console Mobile Application, atau mengambil tindakan lain yang Anda butuhkan.
Jika Amazon DocumentDB membatalkan patch (jarang), Anda menerima pemberitahuan AHD dan email tentang pembatalan tersebut. Gunakan kode `AWS_DOCDB_DB_PATCH_UPGRADE_MAINTENANCE_CANCELLED` acara dengan Amazon EventBridge untuk menangani kasus ini. Untuk selengkapnya tentang aturan penulisan, lihat Panduan EventBridge Pengguna [ Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html).
## Melihat tindakan pemeliharaan Amazon DocumentDB yang tertunda
Gunakan Konsol Manajemen AWS atau AWS CLI untuk memeriksa pemeliharaan apa yang tertunda untuk cluster atau instance.
Pembaruan yang tertunda muncul dengan jenis tindakan`system-update`, yang mencakup patch engine dan pembaruan OS.
Saat pembaruan tertunda, Anda dapat:
+ Terapkan segera.
+ Jadwalkan untuk jendela pemeliharaan berikutnya.
+ Tunda (patch mesin dan pembaruan OS saja) dengan mengubah jendela pemeliharaan Anda sebelumnya`AutoAppliedAfterDate`. Setelah tanggal tersebut berlalu, tindakan akan diterapkan secara otomatis selama jendela pemeliharaan berikutnya. Setelah `ForcedApplyDate` berlalu, tidak ada penangguhan lebih lanjut yang mungkin dilakukan.
**catatan**
Jika Anda tidak mengambil tindakan, tindakan pemeliharaan yang diperlukan seperti patch mesin yang diperlukan akan diterapkan secara otomatis selama jendela pemeliharaan yang akan datang. Tambalan opsional dan versi minor tidak pernah diterapkan secara otomatis.
Jendela pemeliharaan mengontrol kapan operasi yang tertunda * dimulai*, bukan berapa lama waktu yang dibutuhkan untuk menyelesaikannya.
------
#### [ Using the Konsol Manajemen AWS ]
1. Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di [ https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. Pada panel navigasi, silakan pilih **Klaster**.
1. **Kolom Pem ** eliharaan cluster menampilkan Jen ** dela Ter ** sedia**, Diper ** lukan, atau Ber ** ** ikutnya saat pembaruan tertunda.
1. Buka cluster, lalu pilih ** Maintenance & backup ** untuk melihat ** item Pending Main ** tenance dan menindaklanjutinya.
------
#### [ Using the AWS CLI ]
Jalan `describe-pending-maintenance-actions` kan untuk melihat apa yang tertunda. Contoh berikut menunjukkan akun tanpa tindakan yang tertunda.
```
aws docdb describe-pending-maintenance-actions
```
Keluaran dari operasi ini terlihat seperti berikut ini (format JSON).
```
{
"PendingMaintenanceActions": []
}
```
Akun dengan tindakan tertunda mengembalikan output yang terlihat seperti ini:
```
{
"PendingMaintenanceActions": [
{
"ResourceIdentifier": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
"PendingMaintenanceActionDetails": [
{
"Action": "system-update",
"Description": "db-version-upgrade",
"CurrentApplyDate": "2026-05-15T03:01:00Z",
"AutoAppliedAfterDate": "2026-05-15T03:01:00Z"
}
]
}
]
}
```
Anda dapat menjangkau daftar ke cluster tertentu dengan`--filters`, dalam formulir`Name={{filter-name}},Values={{resource-id}},...`. Filter yang diterima `Name` adalah`db-cluster-id`, yang mengambil daftar pengidentifikasi cluster atau ARN.
**Example**
Untuk Linux, macOS, atau Unix:
```
aws docdb describe-pending-maintenance-actions \
--filters Name=db-cluster-id,Values={{sample-cluster1}},{{sample-cluster2}}
```
Untuk Windows:
```
aws docdb describe-pending-maintenance-actions ^
--filters Name=db-cluster-id,Values={{sample-cluster1}},{{sample-cluster2}}
```
------
### Terapkan tanggal
Setiap tindakan pemeliharaan yang tertunda membawa hingga tiga tanggal penerapan. Mereka muncul di AWS CLI output untuk `describe-pending-maintenance-actions` dan menunjukkan kapan tindakan akan berjalan. Bidang adalah `null` untuk pemeliharaan opsional.
+ **CurrentApplyDate**—ketika tindakan dijadwalkan untuk dijalankan, baik sekarang atau di jendela pemeliharaan berikutnya. Dihuni untuk tindakan yang diperlukan dan dipaksakan.
+ **AutoAppliedAfterDate**—tanggal setelah penerapan otomatis dimulai selama jendela pemeliharaan cluster atau instance. Diisi untuk tindakan yang diperlukan.
+ **ForcedApplyDate**tenggat waktu yang sulit. Setelah tanggal ini tindakan berjalan secara otomatis, terlepas dari jendela pemeliharaan Anda. Dihuni untuk tindakan paksa.
Untuk menunda tindakan yang tertunda, pindahkan jendela pemeliharaan Anda ke hari berikutnya sebelumnya`AutoAppliedAfterDate`. Setelah `AutoAppliedAfterDate` berlalu, tindakan akan diterapkan secara otomatis selama jendela pemeliharaan berikutnya. Setelah `ForcedApplyDate` berlalu, tidak ada penangguhan lebih lanjut yang mungkin dilakukan. Jendela penangguhan yang tepat bervariasi per patch; tanggal dipublikasikan dalam pemberitahuan AHD dan output. AWS CLI
## Pembaruan mesin Amazon DocumentDB
Setelah mengidentifikasi patch engine yang tertunda, gunakan salah satu prosedur berikut untuk menerapkan atau menjadwalkannya. Anda dapat menjalankan prosedur ini dari Konsol Manajemen AWS atau AWS CLI.
------
#### [ Using the Konsol Manajemen AWS ]
**Untuk mengelola pembaruan untuk cluster**
1. Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di [ https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. Pada panel navigasi, silakan pilih **Klaster**.
1. Pilih cluster yang ingin Anda perbarui.
1. Dari ** menu T ** indakan, pilih salah satu:
+ **Tingkatkan sekarang ** —jalankan pemeliharaan yang tertunda segera.
+ **Tingkatkan di jendela berikutnya ** —jalankan selama jendela pemeliharaan cluster berikutnya.
Anda juga dapat menggunakan ** Terapkan sekarang ** atau ** Terapkan di jendela pemeliharaan berikutnya ** dari ** bagian ** Pemeliharaan Tertunda pada ** tab ** Pemeliharaan & cadangan cluster (lihat[Melihat tindakan pemeliharaan Amazon DocumentDB yang tertunda](#view-pending-maintenance)).
**catatan**
Jika tidak ada yang tertunda, semua opsi ini tidak aktif.
------
#### [ Using the AWS CLI ]
Terapkan pembaruan yang tertunda dengan`apply-pending-maintenance-action`.
**Parameter**
+ **--resource-identifier**—Amazon DocumentDB Amazon Resource Name (ARN) dari sumber daya yang ditargetkan tindakan tertunda.
+ **--apply-action**—tindakan pemeliharaan yang tertunda untuk diterapkan. Gunakan `system-update` untuk menerapkan patch mesin.
+ **--opt-in-type**—jenis permintaan opt-in, atau apakah akan membatalkannya. Nilai valid:
+ `immediate`Ajukan permohonan sekarang. Tidak dapat dibatalkan setelah dikirimkan.
+ `next-maintenance`—terapkan selama jendela pemeliharaan sumber daya berikutnya.
+ `undo-opt-in`—membatalkan `next-maintenance` opt-in yang ada.
**Example**
Untuk Linux, macOS, atau Unix:
```
aws docdb apply-pending-maintenance-action \
--resource-identifier arn:aws:rds:us-east-1:{{123456789012}}:db:{{sample-cluster-instance-1}} \
--apply-action system-update \
--opt-in-type immediate
```
Untuk Windows:
```
aws docdb apply-pending-maintenance-action ^
--resource-identifier arn:aws:rds:us-east-1:{{123456789012}}:db:{{sample-cluster-instance-1}} ^
--apply-action system-update ^
--opt-in-type immediate
```
------
### Baca ketersediaan selama tambalan
Mesin Amazon DocumentDB 5.0 dan 8.0 mempertahankan ketersediaan baca selama menambal ketika cluster memiliki beberapa instans. Amazon DocumentDB menambal instance pembaca secara bergulir, dalam tiga grup, sehingga pembaca yang tersisa terus melayani lalu lintas. Penulis sebentar tidak tersedia saat menambal. Untuk mencapai waktu henti baca nol, atur preferensi baca Anda sehingga pembacaan dapat kembali ke penulis: `secondaryPreferred` atau `primaryPreferred` berfungsi; `primary` atau `secondary` sendirian dapat menyebabkan waktu henti membaca.
| Baca mode preferensi | Selama peningkatan penulis | Selama pemutakhiran pembaca | Jumlah minimum pembaca yang dibutuhkan untuk waktu henti baca nol |
| --- | --- | --- | --- |
| primary | Read/write waktu henti | Tidak ada dampak | N/A |
| primaryPreferred | Menulis waktu henti | Tidak ada dampak | 1 |
| secondary | Menulis waktu henti | Waktu henti membaca (jika hanya satu pembaca) | 2 |
| secondaryPreferred | Menulis waktu henti | Tidak ada dampak | 1 |
| nearest | Menulis waktu henti | Tidak ada dampak | 1 |
Saat pembaca menambal, throughput pembacaan cluster secara keseluruhan turun sementara. Agar throughput tetap stabil, sediakan pembaca tambahan sebelum peningkatan dan hapus setelah selesai.
Pada engine 3.6 dan 4.0, fitur ketersediaan baca ini tidak berlaku: patch engine menyebabkan downtime yang lebih lama yang memengaruhi pembacaan dan penulisan. Untuk memutakhirkan ke versi utama yang melakukannya, lihat[Pembaruan versi utama Amazon DocumentDB di tempat](docdb-mvu.md).
### Panjang downtime patch
Engine-patch downtime bervariasi. Faktor terbesar adalah pemanfaatan CPU dan tekanan memori pada instance pada saat patch, jadi menentukan ukuran instans yang tepat penting. Untuk meminimalkan waktu henti, jalankan versi engine utama Amazon DocumentDB terbaru dan sebarkan instans di beberapa Zona Ketersediaan.
### Pembaruan dan penggantian patch
Amazon DocumentDB memantau patch setelah rilis. Dalam kasus yang jarang terjadi ketika masalah teridentifikasi, Amazon DocumentDB menjeda peluncuran saat menyiapkan versi yang diperbarui. Ketika ini terjadi, cluster yang belum menerima patch tidak lagi melihatnya sebagai tindakan pemeliharaan yang tersedia, dan pemberitahuan perubahan terjadwal terkait di patch Dasbor Health ditarik. Cluster yang sudah menjalankan versi yang terpengaruh terus beroperasi secara normal dan tidak memerlukan tindakan dari Anda.
Patch yang diperbarui segera menyusul. Ketika tersedia di Wilayah Anda, Anda menerima pemberitahuan baru melalui e-mail Dasbor Health dan, seperti yang dijelaskan di[Pemberitahuan untuk patch mesin Amazon DocumentDB](#patch-notifications).
## Peningkatan versi minor
Amazon DocumentDB menerbitkan versi minor di atas versi utama 5.0 dan yang lebih baru (misalnya,`5.0.1`). Versi minor tidak dipublikasikan untuk versi utama yang lebih awal dari 5.0. Versi minor berperilaku berbeda dari patch mesin yang diperlukan dan opsional:
+ Mereka tidak muncul sebagai tindakan pemeliharaan yang tertunda dan tidak pernah diterapkan secara otomatis.
+ Mereka tidak menghasilkan pemberitahuan AHD atau email. Versi minor baru diumumkan dalam catatan [https://docs.aws.amazon.com/documentdb/latest/devguide/release-notes.html](https://docs.aws.amazon.com/documentdb/latest/devguide/release-notes.html) rilis Amazon DocumentDB.
+ Untuk memutakhirkan, Anda memodifikasi versi mesin cluster (segera atau selama jendela pemeliharaan berikutnya). Upgrade versi minor memerlukan waktu henti singkat dan bersifat satu arah — Anda tidak dapat menurunkan versi ke versi minor sebelumnya. Untuk cluster global, tingkatkan cluster sekunder sebelum cluster primer.
Baca lebih lanjut:[Peningkatan versi minor Amazon DocumentDB](docdb-minor-version-upgrade.md).
## Pembaruan sistem operasi Amazon DocumentDB
Instans terkadang membutuhkan pembaruan OS. Amazon DocumentDB memperbarui OS untuk meningkatkan kinerja dan memperketat keamanan. Pembaruan OS membuat versi mesin cluster dan kelas instance tidak berubah. Seperti patch mesin, pembaruan OS menggunakan siklus hidup opsional/wajib/paksa yang dijelaskan di bagian atas topik ini; tidak seperti patch mesin, pembaruan OS dapat beralih melalui kategori ini dari waktu ke waktu jika Anda menundanya. Terapkan pembaruan OS segera setelah tersedia, dan atur jendela pemeliharaan cluster dan instans Anda ke waktu yang sesuai dengan kebutuhan bisnis Anda.
Gunakan tindakan `os-upgrade` pemeliharaan tingkat cluster untuk menerapkan pembaruan OS di semua instans dalam cluster. Amazon DocumentDB memperbarui instans secara bergulir, beberapa pada satu waktu, dan memperbarui instans utama terakhir untuk meminimalkan failover. Pembaruan berjalan selama jendela pemeliharaan kluster—bukan jendela pemeliharaan instans individu—yang Anda konfigurasikan.
Setelah instance menerima pembaruan OS, cache buffernya mulai kosong. Sampai kumpulan kerja diisi ulang dari volume penyimpanan, kueri pada instance tersebut dapat mengalami latensi yang lebih tinggi dan lebih rendah`BufferCacheHitRatio`.
Saat Amazon DocumentDB memperbarui instance utama, failover mempromosikan replika menjadi primer baru. Gunakan titik akhir cluster sehingga aplikasi Anda menangani ini secara transparan. Untuk mempertahankan ketersediaan baca saat instans sedang diperbarui, setel preferensi baca Anda ke `secondaryPreferred` atau `primaryPreferred` agar pembacaan dapat kembali ke instance yang tersedia. Simpan target failover potensial (replika dengan tingkat prioritas tertinggi) pada kelas instans yang sama dengan yang utama. Ini menghindari penurunan kinerja tulis setelah promosi. Lihat perinciannya di [Failover Amazon DocumentDB](failover.md).
Tindakan tingkat cluster `os-upgrade` dan tingkat instance mungkin muncul secara bersamaan `system-update` sebagai tindakan yang tersedia. `describe-pending-maintenance-actions` Namun, Anda tidak dapat menjadwalkan keduanya secara bersamaan. Jika `system-update` tindakan tingkat instance dijadwalkan secara aktif pada instans apa pun, Anda harus membatalkan atau menyelesaikannya sebelum menjadwalkan `os-upgrade` tindakan tingkat cluster, dan sebaliknya.
**penting**
Instans Amazon DocumentDB Anda akan offline untuk pembaruan OS. Multi-instance cluster meminimalkan dampaknya. Jika Anda menjalankan cluster instans tunggal, Anda dapat menambahkan sementara sekunder untuk pembaruan dan menghapusnya setelahnya. Yang sekunder menimbulkan biaya biasa saat ada.
**catatan**
Tindakan tingkat instance `system-update` masih tersedia untuk kompatibilitas mundur. Jika Anda harus menggunakannya, perbarui replika terlebih dahulu dan yang utama terakhir—hindari menambal secara bersamaan, karena failover selama patch dapat memperpanjang waktu henti.
Untuk mendapatkan acara saat pembaruan OS opsional baru tiba, berlangganan `RDS-EVENT-0230` di kategori acara tambalan keamanan. Untuk informasi selengkapnya, lihat [Berlangganan acara Amazon DocumentDB](event-subscriptions.subscribe.md).
**catatan**
Tetap terkini tentang pembaruan opsional dan wajib mungkin diperlukan untuk kepatuhan. Terapkan `os-upgrade` tindakan secara rutin selama jendela pemeliharaan Anda.
Pembaruan OS terkait dengan kelas instance tertentu, sehingga instans yang berbeda menjadi memenuhi syarat pada waktu yang berbeda. Jika cluster Anda tidak menggunakan patch engine terbaru, pembaruan OS mungkin tidak muncul — terapkan patch engine terbaru terlebih dahulu (lihat[Pembaruan mesin Amazon DocumentDB](#db-instance-updates-apply)).
Gunakan Konsol Manajemen AWS atau AWS CLI untuk memeriksa apakah pembaruan tersedia.
------
#### [ Using the Konsol Manajemen AWS ]
Untuk memeriksa pembaruan OS dari konsol:
1. Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di [ https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. Di panel navigasi, pilih ** Cluster**, lalu pilih nama cluster.
1. Pilih ** tab ** Maintenance & backup.
1. Di ** bawah Pemeliharaan Tertunda**, `os-upgrade` tindakan muncul jika pembaruan OS tersedia.
1. Pilih `os-upgrade` tindakan dan pilih Ter ** apkan sekarang ** atau Ter ** apkan di jendela pemeliharaan berikutnya**. Jika nilainya adalah jendela ** berikutnya**, Anda dapat menunda ** dengan Tunda ** peningkatan selama tindakan belum dimulai.
------
#### [ Using the AWS CLI ]
Periksa pembaruan OS yang tertunda:
```
aws docdb describe-pending-maintenance-actions
```
```
{
"PendingMaintenanceActions": [
{
"ResourceIdentifier": "arn:aws:rds:aa-example-1:111122223333:cluster:sample-cluster",
"PendingMaintenanceActionDetails": [
{
"Action": "os-upgrade",
"Description": "New Operating System update is available"
}
]
},
{
"ResourceIdentifier": "arn:aws:rds:aa-example-1:111122223333:db:sample-cluster-instance-1",
"PendingMaintenanceActionDetails": [
{
"Action": "system-update",
"Description": "New Operating System update is available"
}
]
},
{
"ResourceIdentifier": "arn:aws:rds:aa-example-1:111122223333:db:sample-cluster-instance-2",
"PendingMaintenanceActionDetails": [
{
"Action": "system-update",
"Description": "New Operating System update is available"
}
]
}
]
}
```
Pembaruan OS muncul di tingkat cluster sebagai `os-upgrade` dan pada tingkat instance sebagai`system-update`. Gunakan tindakan tingkat cluster. `os-upgrade`
**Example**
Contoh berikut menerapkan pembaruan OS segera.
Untuk Linux, macOS, atau Unix:
```
aws docdb apply-pending-maintenance-action \
--resource-identifier arn:aws:rds:{{aa-example-1}}:{{111122223333}}:cluster:{{sample-cluster}} \
--apply-action os-upgrade \
--opt-in-type immediate
```
Untuk Windows:
```
aws docdb apply-pending-maintenance-action ^
--resource-identifier arn:aws:rds:{{aa-example-1}}:{{111122223333}}:cluster:{{sample-cluster}} ^
--apply-action os-upgrade ^
--opt-in-type immediate
```
------
## User-initiated pembaruan
Beberapa perubahan Anda mulai sendiri—misalnya, menukar kelas instance dengan kelas dengan memori lebih banyak atau lebih sedikit, atau mengubah grup parameter cluster. Amazon DocumentDB memperlakukan ini secara berbeda dari pembaruan yang dimulainya. Untuk detailnya, lihat:
+ [Memodifikasi cluster Amazon DocumentDB](db-cluster-modify.md)
+ [Memodifikasi instance Amazon DocumentDB](db-instance-modify.md)
Untuk membuat daftar perubahan yang diprakarsai pengguna yang masih tertunda:
**Example**
**Untuk membuat daftar perubahan yang diprakarsai pengguna yang tertunda untuk instans Anda **
Untuk Linux, macOS, atau Unix:
```
aws docdb describe-db-instances \
--query 'DBInstances[*].[DBClusterIdentifier,DBInstanceIdentifier,PendingModifiedValues]'
```
Untuk Windows:
```
aws docdb describe-db-instances ^
--query 'DBInstances[*].[DBClusterIdentifier,DBInstanceIdentifier,PendingModifiedValues]'
```
Keluaran dari operasi ini terlihat seperti berikut ini (format JSON).
Dalam contoh ini, `sample-cluster-instance` memiliki perubahan yang tertunda ke`db.r5.xlarge`; `sample-cluster-instance-2` has none.
```
[
[
"sample-cluster",
"sample-cluster-instance",
{
"DBInstanceClass": "db.r5.xlarge"
}
],
[
"sample-cluster",
"sample-cluster-instance-2",
{}
]
]
```
## Penambalan klaster global
Dalam cluster global, setiap cluster anggota—primer dan sekunder—melakukan upgrade selama jendela pemeliharaannya sendiri. Ketika patch mesin yang diperlukan tersedia di setiap Wilayah, Anda menerima pemberitahuan AHD dan email. Patch opsional dan versi minor baru tidak menghasilkan pemberitahuan; periksa catatan [ rilis Amazon DocumentDB ](https://docs.aws.amazon.com/documentdb/latest/devguide/release-notes.html) untuk itu.
Jika Anda mendaftar sendiri, selalu tambal sekunder terlebih dahulu dan yang utama terakhir. Pesanan ini membuat failover dan switchover tersedia selama peluncuran.
**penting**
Jika Anda menambal yang utama terlebih dahulu secara tidak sengaja, bawa semua sekunder ke versi yang sama sesegera mungkin. Failover dan switchover tetap dinonaktifkan sampai setiap cluster berada pada versi yang sama.
Jika Anda tidak mengambil tindakan, patch akan diterapkan secara otomatis selama jendela pemeliharaan berikutnya setiap cluster: sekunder terlebih dahulu, lalu primer di jendelanya setelah sekunder selesai.
Pertahankan cluster DB primer dan sekunder pada versi yang sama. Failover lintas wilayah yang dikelola hanya berfungsi pada database global ketika setiap cluster berbagi versi engine dan tingkat patch yang sama. Hal yang sama berlaku jika Anda menambahkan sekunder baru yang menggunakan versi engine yang lebih baru daripada versi primer — buat sekunder baru pada versi primer sebelum menggabungkannya ke database global.
Setelah pemberitahuan patch, tingkatkan versi primer dan sekunder ke versi terbaru sesegera mungkin agar failover dan switchover tetap berfungsi. Jika permintaan failover atau switchover ditolak, bandingkan versi patch engine di seluruh cluster; jika tidak cocok, terapkan patch yang tersedia pada cluster yang tertinggal.