

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
<a name="AuroraMySQL.Upgrading.Procedure"></a>

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
<a name="AuroraMySQL.Upgrading.ModifyingDBCluster.CON"></a>

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.  
![\[Peningkatan di tempat terhadap klaster DB Aurora MySQL dari versi 2 ke versi 3\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/AuroraUserGuide/images/ams-upgrade-v2-v3.png)

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 Aurora Peningkatan di tempat saya SQL](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
<a name="AuroraMySQL.Upgrading.ModifyingDBCluster.CLI"></a>

Untuk memutakhirkan versi utama cluster DB MySQL Aurora, gunakan AWS CLI [modify-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html)perintah dengan parameter yang diperlukan berikut:
+ `--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 `modify-db-cluster` untuk membuat end-to-end proses otomatis untuk melakukan dan memverifikasi peningkatan. Untuk informasi selengkapnya dan contoh tambahan, lihat [Aurora Tutorial peningkatan di tempat SQL saya](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 [modify-global-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-global-cluster.html)perintah alih-alih`modify-db-cluster`. Untuk informasi selengkapnya, lihat [Peningkatan besar di tempat untuk basis data global](#AuroraMySQL.Upgrading.GlobalDB).

## API RDS
<a name="AuroraMySQL.Upgrading.ModifyingDBCluster.API"></a>

[Untuk memutakhirkan versi utama cluster DB MySQL Aurora, gunakan operasi RDS API Modify dengan parameter yang diperlukan berikut: DBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html)
+ `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 [Peningkatan besar di tempat untuk basis data global](#AuroraMySQL.Upgrading.GlobalDB).

## Bagaimana peningkatan di tempat memengaruhi grup parameter untuk klaster
<a name="AuroraMySQL.Upgrading.ParamGroups"></a>

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
<a name="AuroraMySQL.Upgrading.Attrs"></a>

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
```

## Peningkatan besar di tempat untuk basis data global
<a name="AuroraMySQL.Upgrading.GlobalDB"></a>

 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**.

![\[Meningkatkan klaster basis data global\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/AuroraUserGuide/images/aurora-global-databases-major-upgrade-global-cluster.png)


 Jika Anda menggunakan AWS CLI atau RDS API, mulai proses upgrade dengan memanggil [modify-global-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-global-cluster.html)perintah atau [ModifyGlobalCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyGlobalCluster.html)operasi. 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 sebuah cluster database global MySQL Aurora dengan menggunakan AWS CLI, gunakan [modify-global-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-global-cluster.html)perintah dengan parameter yang diperlukan berikut: 
+  `--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
```

## Upgrade di tempat untuk cluster DB dengan replika baca lintas wilayah
<a name="AuroraMySQL.Upgrading.XRRR"></a>

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 cluster DB test-xr-primary-cluster karena replika Aurora Cross-region 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 klaster 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 