Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Cara melakukan peningkatan di tempat
Sebaiknya Anda meninjau materi latar belakang dalam [Cara kerja peningkatan di tempat terhadap versi mayor Aurora MySQL](AuroraMySQL.Updates.MajorVersionUpgrade.md#AuroraMySQL.Upgrading.Sequence).
Lakukan perencanaan dan pengujian pra-upgrade, seperti yang dijelaskan dalam[Merencanakan peningkatan versi mayor untuk klaster Aurora MySQL](AuroraMySQL.Updates.MajorVersionUpgrade.md#AuroraMySQL.Upgrading.Planning).
## Konsol
Contoh berikut meningkatkan cluster `mydbcluster-cluster` DB ke Aurora MySQL versi 3.04.1.
**Untuk meningkatkan versi mayor klaster DB Aurora MySQL**
1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon RDS di [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. Jika Anda menggunakan grup parameter kustom untuk klaster DB asli, buat grup parameter terkait yang kompatibel dengan versi mayor baru. Buat penyesuaian yang diperlukan untuk parameter konfigurasi di grup parameter baru tersebut. Untuk informasi selengkapnya, lihat [Bagaimana peningkatan di tempat memengaruhi grup parameter untuk klaster](#AuroraMySQL.Upgrading.ParamGroups).
1. Di panel navigasi, pilih **Basis Data**.
1. Dalam daftar, pilih klaster DB yang ingin Anda ubah.
1. Pilih **Ubah**.
1. Untuk **Versi**, pilih versi mayor Aurora MySQL baru.
Biasanya, kami merekomendasikan untuk menggunakan versi minor terbaru dari versi mayor. Di sini, kami memilih versi default saat ini.
1. Pilih **Lanjutkan**.
1. Di halaman berikutnya, tentukan kapan harus melakukan peningkatan. Pilih **Selama jendela pemeliharaan terjadwal berikutnya** atau **Segera**.
1. (Opsional) Periksa secara berkala halaman **Peristiwa** di konsol RDS selama peningkatan. Tindakan ini akan membantu Anda memantau progres peningkatan dan identifikasi masalah apa pun. Jika peningkatan mengalami masalah apa pun, lihat [Pemecahan masalah untuk peningkatan di tempat Aurora MySQL](AuroraMySQL.Upgrading.Troubleshooting.md) untuk langkah-langkah yang harus diambil.
1. Jika Anda membuat grup parameter baru di awal prosedur ini, kaitkan grup parameter kustom dengan klaster yang ditingkatkan. Untuk informasi selengkapnya, lihat [Bagaimana peningkatan di tempat memengaruhi grup parameter untuk klaster](#AuroraMySQL.Upgrading.ParamGroups).
**catatan**
Langkah ini mengharuskan Anda untuk memulai ulang klaster lagi untuk menerapkan grup parameter baru.
1. (Opsional) Setelah Anda menyelesaikan setiap pengujian pasca-peningkatan, hapus snapshot manual yang dibuat Aurora pada awal peningkatan.
## AWS CLI
Untuk memutakhirkan versi utama cluster DB MySQL Aurora, gunakan perintah AWS CLI [modify-db-cluster dengan parameter yang diperlukan berikut](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html):
+ `--db-cluster-identifier`
+ `--engine-version`
+ `--allow-major-version-upgrade`
+ `--apply-immediately` atau `--no-apply-immediately`
Jika klaster Anda menggunakan grup parameter kustom, sertakan juga salah satu atau kedua opsi berikut ini:
+ `--db-cluster-parameter-group-name`, jika klaster menggunakan grup parameter klaster kustom
+ `--db-instance-parameter-group-name`, jika ada instans di klaster yang menggunakan grup parameter DB kustom
Contoh berikut meningkatkan cluster `sample-cluster` DB ke Aurora MySQL versi 3.04.1. Peningkatan akan segera terjadi, bukan menunggu periode pemeliharaan berikutnya.
**Example**
Untuk Linux, macOS, atau Unix:
```
aws rds modify-db-cluster \
--db-cluster-identifier sample-cluster \
--engine-version 8.0.mysql_aurora.3.04.1 \
--allow-major-version-upgrade \
--apply-immediately
```
Untuk Windows:
```
aws rds modify-db-cluster ^
--db-cluster-identifier sample-cluster ^
--engine-version 8.0.mysql_aurora.3.04.1 ^
--allow-major-version-upgrade ^
--apply-immediately
```
Anda dapat menggabungkan perintah CLI lainnya dengan `modify-db-cluster` untuk membuat proses otomatis yang menyeluruh untuk melakukan dan memverifikasi peningkatan. Untuk informasi selengkapnya dan contoh tambahan, lihat [Tutorial peningkatan di tempat Aurora MySQL](AuroraMySQL.Upgrading.Tutorial.md).
**catatan**
Jika klaster Anda adalah bagian dari basis data global Aurora, prosedur peningkatan di tempat ini sedikit berbeda. Anda memanggil operasi perintah [modify-global-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-global-cluster.html), bukannya `modify-db-cluster`. Untuk informasi selengkapnya, lihat [In-place upgrade besar untuk database global](#AuroraMySQL.Upgrading.GlobalDB).
## API RDS
Untuk meningkatkan versi mayor klaster DB Aurora MySQL, gunakan perintah [ModifyDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html) API RDS dengan parameter wajib berikut:
+ `DBClusterIdentifier`
+ `Engine`
+ `EngineVersion`
+ `AllowMajorVersionUpgrade`
+ `ApplyImmediately` (atur ke `true` atau `false`)
**catatan**
Jika klaster Anda adalah bagian dari basis data global Aurora, prosedur peningkatan di tempat ini sedikit berbeda. Anda memanggil [ModifyGlobalCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyGlobalClusterParameterGroup.html)operasi alih-alih`ModifyDBCluster`. Untuk informasi selengkapnya, lihat [In-place upgrade besar untuk database global](#AuroraMySQL.Upgrading.GlobalDB).
## Bagaimana peningkatan di tempat memengaruhi grup parameter untuk klaster
Grup parameter Aurora memiliki kumpulan pengaturan konfigurasi yang berbeda untuk klaster yang kompatibel dengan MySQL 5.7 atau 8.0. Saat Anda melakukan peningkatan di tempat, klaster yang ditingkatkan dan semua instans harus menggunakan grup parameter klaster dan instans yang sesuai:
Klaster dan instans Anda mungkin menggunakan grup parameter default yang kompatibel dengan 5.7. Jika demikian, klaster dan instans yang ditingkatkan akan dimulai dengan grup parameter default yang kompatibel dengan 8.0. Jika klaster dan instans Anda menggunakan grup parameter kustom apa pun, pastikan untuk membuat grup parameter yang sesuai atau yang kompatibel dengan 8.0. Pastikan juga untuk menentukannya selama proses peningkatan.
**catatan**
Untuk sebagian besar pengaturan parameter, Anda dapat memilih grup parameter kustom di dua titik. Titik ini adalah saat Anda membuat klaster atau mengaitkan grup parameter dengan klaster nanti.
Namun, jika Anda menggunakan pengaturan nondefault untuk parameter `lower_case_table_names`, Anda harus mengatur grup parameter kustom dengan pengaturan ini terlebih dahulu. Kemudian, tentukan grup parameter saat Anda melakukan pemulihan snapshot untuk membuat klaster. Setiap perubahan pada parameter `lower_case_table_names` tidak akan berpengaruh setelah klaster dibuat.
Kami menyarankan Anda menggunakan pengaturan yang sama untuk `lower_case_table_names` ketika Anda meningkatkan dari Aurora MySQL versi 2 ke versi 3.
Dengan database global Aurora berdasarkan Aurora MySQL, Anda dapat melakukan peningkatan di tempat dari Aurora MySQL versi 2 ke versi 3 hanya jika Anda mengatur parameter ke default dan me-reboot database global Anda. `lower_case_table_names` Untuk informasi selengkapnya tentang metode yang dapat Anda gunakan, lihat [Peningkatan versi utama](aurora-global-database-upgrade.md#aurora-global-database-upgrade.major).
## Perubahan pada properti klaster di antara versi Aurora MySQL
Saat Anda meningkatkan dari Aurora MySQL versi 2 ke versi 3, pastikan untuk memeriksa aplikasi atau skrip apa pun yang Anda gunakan untuk menyiapkan atau mengelola klaster dan instans DB Aurora MySQL.
Selain itu, ubah kode Anda yang memanipulasi grup parameter untuk memperhitungkan fakta bahwa nama grup parameter default berbeda untuk klaster yang kompatibel dengan 5.7 dan 8.0. Nama grup parameter default untuk klaster Aurora MySQL versi 2 dan 3 masing-masing adalah `default.aurora-mysql5.7` dan `default.aurora-mysql8.0`.
Misalnya, Anda mungkin memiliki kode seperti berikut yang berlaku untuk klaster Anda sebelum peningkatan.
```
# Check the default parameter values for MySQL 5.7–compatible clusters.
aws rds describe-db-parameters {{--db-parameter-group-name default.aurora-mysql5.7}} --region us-east-1
```
Setelah meningkatkan versi mayor klaster, ubah kode tersebut sebagai berikut.
```
# Check the default parameter values for MySQL 8.0–compatible clusters.
aws rds describe-db-parameters {{--db-parameter-group-name default.aurora-mysql8.0}} --region us-east-1
```
## In-place upgrade besar untuk database global
Untuk basis data global Aurora, Anda meningkatkan klaster basis data global. Aurora secara otomatis meningkatkan semua klaster pada saat yang sama dan memastikan bahwa semua klaster ini menjalankan versi mesin yang sama. Persyaratan ini berlaku karena setiap perubahan pada tabel sistem, format file data, dan sebagainya akan secara otomatis direplikasi ke semua klaster sekunder.
Ikuti petunjuk dalam [Cara kerja peningkatan di tempat terhadap versi mayor Aurora MySQL](AuroraMySQL.Updates.MajorVersionUpgrade.md#AuroraMySQL.Upgrading.Sequence). Saat Anda menentukan hal yang akan ditingkatkan, pastikan untuk memilih klaster basis data global, bukan salah satu klaster yang terdapat di dalamnya.
Jika Anda menggunakan Konsol Manajemen AWS, pilih item dengan peran **Database global**.
Jika Anda menggunakan API AWS CLI atau RDS, mulailah proses pemutakhiran dengan memanggil perintah atau operasi [modify-global-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-global-cluster.html). [ModifyGlobalCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyGlobalCluster.html) Anda akan menggunakan salah satunya, bukan `modify-db-cluster` atau `ModifyDBCluster`.
**catatan**
Anda tidak dapat menentukan grup parameter kustom untuk klaster basis data global saat Anda melakukan peningkatan versi mayor basis data global Aurora tersebut. Buat grup parameter kustom Anda di setiap Wilayah klaster global. Kemudian, terapkan secara manual ke klaster Regional setelah peningkatan.
Untuk meng-upgrade versi utama dari cluster database global MySQL Aurora dengan menggunakan, gunakan perintah AWS CLI[modify-global-cluster dengan parameter yang diperlukan berikut](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-global-cluster.html):
+ `--global-cluster-identifier`
+ `--engine aurora-mysql`
+ `--engine-version`
+ `--allow-major-version-upgrade`
Contoh berikut meningkatkan cluster database global ke Aurora MySQL versi 3.04.2.
**Example**
Untuk Linux, macOS, atau Unix:
```
aws rds modify-global-cluster \
--global-cluster-identifier {{global_cluster_identifier}} \
--engine aurora-mysql \
--engine-version 8.0.mysql_aurora.3.04.2 \
--allow-major-version-upgrade
```
Untuk Windows:
```
aws rds modify-global-cluster ^
--global-cluster-identifier {{global_cluster_identifier}} ^
--engine aurora-mysql ^
--engine-version 8.0.mysql_aurora.3.04.2 ^
--allow-major-version-upgrade
```
## In-place upgrade untuk cluster DB dengan replika baca lintas wilayah
Anda dapat memutakhirkan cluster Aurora DB yang memiliki replika baca lintas wilayah menggunakan prosedur peningkatan di tempat, tetapi ada pertimbangan tertentu:
+ Anda harus memutakhirkan cluster DB replika baca terlebih dahulu. Jika Anda mencoba memutakhirkan klaster utama terlebih dahulu, Anda akan menerima pesan kesalahan seperti berikut ini:
Tidak dapat memutakhirkan DB cluster test-xr-primary-cluster karena replika Aurora Cross-region yang terkait test-xr-replica-cluster belum ditambal. Tingkatkan replika Aurora Cross-region dan coba lagi.
Ini berarti bahwa cluster DB primer tidak dapat memiliki versi mesin DB yang lebih tinggi daripada cluster replika.
+ Sebelum Anda memutakhirkan cluster DB primer, hentikan beban kerja tulis dan nonaktifkan permintaan koneksi baru apa pun ke instance DB penulis dari cluster utama.
+ Saat Anda memutakhirkan cluster utama, pilih grup parameter cluster DB kustom dengan `binlog_format` parameter yang disetel ke nilai yang mendukung replikasi logging biner, seperti`MIXED`.
Untuk informasi selengkapnya tentang menggunakan pencatatan log biner dengan Aurora MySQL, lihat [Replikasi antara Aurora dan MySQL atau antara Aurora dan klaster DB Aurora lainnya (replikasi log biner)](AuroraMySQL.Replication.MySQL.md). Untuk informasi selengkapnya tentang memodifikasi parameter konfigurasi Aurora MySQL, lihat [Parameter konfigurasi Aurora MySQL](AuroraMySQL.Reference.ParameterGroups.md) dan [](USER_WorkingWithParamGroups.md).
+ Jangan menunggu lama untuk memutakhirkan cluster DB utama setelah Anda memutakhirkan cluster replika. Kami menyarankan untuk tidak menunggu lebih lama dari jendela pemeliharaan berikutnya.
+ Setelah Anda memutakhirkan cluster DB primer, reboot instance DB penulisnya. Grup parameter cluster DB kustom yang memungkinkan replikasi binlog tidak berlaku sampai instance DB penulis di-boot ulang.
+ Jangan melanjutkan beban kerja tulis atau mengaktifkan koneksi ke instans DB penulis sampai Anda mengonfirmasi bahwa replikasi lintas wilayah telah dimulai ulang, dan bahwa jeda replika di sekunder adalah 0. Wilayah AWS