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

Gunakan perintah gcloud sql instances patch dengan flag --database-version.

Ganti variabel berikut sebelum menjalankan perintah:

  • INSTANCE_NAME: Nama instance.
  • DATABASE_VERSION: Versi database dari instance. Jika Anda tidak menentukan flag ini, versi utama default akan digunakan.
gcloud sql instances patch INSTANCE_NAME \
--database-version=DATABASE_VERSION

REST v1

Gunakan permintaan PATCH dengan metode instances:patch dan flag databaseVersion.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT-ID: ID project
  • INSTANCE-ID: ID instance
  • DATABASE_VERSION: Versi database yang akan diupgrade.

Metode HTTP dan URL: 

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

Meminta isi JSON: 

{
  "databaseVersion": "DATABASE_VERSION"
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "kind": "sql#operation",
  "targetLink": "https://content-sqladmin.googleapis.com/v1/projects/PROJECT-ID/instances/INSTANCE-ID",
  "status": "PENDING",
  "user": "user@example.com",
  "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"
}

REST v1beta4

Gunakan permintaan PATCH dengan metode instances:patch dan flag databaseVersion.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT-ID: ID project
  • INSTANCE-ID: ID instance
  • DATABASE_VERSION: Versi database yang akan diupgrade.

Metode HTTP dan URL: 

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

Meminta isi JSON: 

{
  "databaseVersion": "DATABASE_VERSION"
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "kind": "sql#operation",
  "targetLink": "https://content-sqladmin.googleapis.com/v1beta4/projects/PROJECT-ID/instances/INSTANCE-ID",
  "status": "PENDING",
  "user": "user@example.com",
  "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.