Mengupgrade versi minor database

Halaman ini menjelaskan cara menetapkan versi minor database dari sebuah instance. Untuk versi yang didukung, lihat Kebijakan versi dan versi database.

Dalam setiap versi minor baru, penyedia database merilis fitur, patch keamanan, perbaikan bug, dan peningkatan performa baru. Selain itu, Cloud SQL secara rutin mengupdate versi minor Anda selama pemeliharaan.

Namun, MySQL 8.0 tidak mendukung downgrade. Dengan demikian, upgrade versi minor tidak otomatis disertakan dalam pemeliharaan rutin. Anda dapat menentukan versi minor untuk Cloud SQL untuk MySQL 8.0 saat membuat instance atau nanti melalui proses upgrade. Keduanya akan dijelaskan di halaman ini.

Sebelum mengupgrade ke MySQL 8.0 versi minor baru, pahami perubahannya. Lihat Catatan Rilis MySQL 8.0. Jika Anda menggunakan Cloud SQL untuk MySQL 5.6 atau 5.7, Cloud SQL akan otomatis mengelola versi minor instance Anda. Saat Anda menyediakan instance baru, Cloud SQL akan otomatis mengonfigurasi instance dengan versi database terbaru yang tersedia. Selama pemeliharaan rutin, Cloud SQL akan otomatis mengupgrade instance Anda ke versi terbaru yang didukung.

Untuk mengupgrade versi minor database dari instance MySQL 8.0, Anda harus mengupdate instance dengan versi minor pilihan Anda, yang harus lebih besar daripada versi minor yang saat ini terinstal. Anda tidak dapat mengembalikan ke versi minor yang tidak ditentukan setelah instance disediakan.

Sebelum Anda mengupgrade

MySQL 8.0 tidak mengizinkan downgrade. Jadi, sebelum mengupgrade instance utama, ikuti langkah-langkah berikut untuk memastikan keamanan data Anda.

1. Uji upgrade Anda di lingkungan staging.

   1. Buat clone instance produksi Anda untuk berfungsi sebagai instance staging. Tindakan ini akan membuat instance database baru, dengan versi utama dan minor yang sama.

   2. Melakukan upgrade versi minor pada instance staging.

   3. Jalankan pengujian beban kerja untuk memverifikasi bahwa upgrade berhasil dan aplikasi Anda berperforma seperti yang diharapkan. Setelah pengujian berhasil, lanjutkan untuk mengupgrade instance replika baca Anda.

2. Upgrade instance replika baca Anda.

   1. Upgrade semua replika baca dalam database ke versi minor target.

   2. Verifikasi bahwa aplikasi Anda berfungsi seperti yang diharapkan.

3. Cadangkan instance utama Anda.

   Seperti halnya update database yang signifikan, cadangkan instance utama Anda.

Mengupgrade versi minor

Anda dapat menentukan versi minor database dari instance yang ada dengan menggunakan gcloud atau REST API. Melakukan upgrade versi minor pada saat database tidak digunakan. Instance dimulai ulang selama operasi, yang menyebabkan periode nonaktif. Jika versi yang saat ini diinstal lebih tinggi dari versi yang diminta, permintaan akan ditolak.

gcloud sql instances patch INSTANCE_NAME \
--database-version=DATABASE_VERSION

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT-ID/instances/INSTANCE-ID

{
  "databaseVersion": "DATABASE_VERSION"
}

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT-ID/instances/INSTANCE-ID"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT-ID/instances/INSTANCE-ID" | Select-Object -Expand Content

{
  "kind": "sql#operation",
  "targetLink": "https://content-sqladmin.googleapis.com/v1/projects/PROJECT-ID/instances/INSTANCE-ID",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2022-07-17T20:23:15.540Z",
  "operationType": "UPDATE",
  "name": "fa3f7304-ccf6-4d2f-a6f5-24df00000032",
  "targetId": "INSTANCE-ID",
  "selfLink": "https://content-sqladmin.googleapis.com/v1/projects/PROJECT-ID/operations/fa3f7304-ccf6-4d2f-a6f5-24df00000032",
  "targetProject": "PROJECT-ID"
}

 https://sqladmin.googleapis.com/v1beta4/projects/PROJECT-ID/instances/INSTANCE-ID

{
  "databaseVersion": "DATABASE_VERSION"
}

curl -X  \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT-ID/instances/INSTANCE-ID"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method  `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT-ID/instances/INSTANCE-ID" | Select-Object -Expand Content

{
  "kind": "sql#operation",
  "targetLink": "https://content-sqladmin.googleapis.com/v1beta4/projects/PROJECT-ID/instances/INSTANCE-ID",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2022-07-17T20:23:15.540Z",
  "operationType": "UPDATE",
  "name": "fa3f7304-ccf6-4d2f-a6f5-24df00000032",
  "targetId": "INSTANCE-ID",
  "selfLink": "https://content-sqladmin.googleapis.com/v1beta4/projects/PROJECT-ID/operations/fa3f7304-ccf6-4d2f-a6f5-24df00000032",
  "targetProject": "PROJECT-ID"
}

Memeriksa versi minor database yang diinstal

Saat Anda melihat informasi ringkasan instance, versi minor database yang diinstal dapat dilihat di bagian Konfigurasi.

Me-roll back upgrade

Saat menguji upgrade, jika menemukan masalah, Anda mungkin ingin melakukan roll back database untuk memulihkan instance database yang menjalankan versi minor sebelumnya.

Untuk memulihkan cadangan yang belum diupgrade, selesaikan langkah-langkah berikut:

1. Menyediakan instance database pemulihan pada versi minor sebelumnya.
2. Konfigurasikan setelan pada instance database pemulihan ke status belum diupgrade.
3. Pulihkan cadangan belum diupgrade yang Anda ambil ke instance pemulihan.

Sebagai alternatif untuk memulihkan cadangan, lakukan pemulihan point-in-time dan buat instance baru.