Mengupgrade versi minor database

MySQL   |  PostgreSQL   |  SQL Server

Halaman ini menjelaskan cara mengupgrade versi minor instance MySQL. Untuk versi yang didukung, lihat Kebijakan versi dan versi database.

Catatan: Untuk mengupgrade versi utama database, lihat Mengupgrade versi utama database dengan memigrasikan data atau Mengupgrade versi utama database yang diterapkan.

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 terinstal. Anda tidak dapat mengembalikan ke versi minor yang tidak ditentukan setelah instance disediakan.

Jika Anda menjalankan instance edisi Cloud SQL Enterprise Plus, upgrade versi minor akan selesai dengan periode nonaktif nyaris nol.

Sebelum Anda mengupgrade

Cloud SQL mendukung upgrade versi minor untuk instance MySQL 8.0. MySQL 8.0 tidak mengizinkan downgrade. Jadi, sebelum mengupgrade instance utama, ikuti langkah-langkah berikut untuk memastikan keamanan data Anda.

1. Pilih versi minor target database.

   gcloud

   Untuk mengetahui informasi tentang menginstal dan memulai gcloud CLI, lihat Menginstal gcloud CLI. Untuk mengetahui informasi tentang cara memulai Cloud Shell, lihat Menggunakan Cloud Shell.

   Untuk memeriksa versi minor database yang tersedia untuk upgrade langsung, lakukan tindakan berikut:

   1. Jalankan perintah berikut.

   gcloud sql instances describe INSTANCE_NAME
      

   Ganti INSTANCE_NAME dengan nama instance.

   2. Di output perintah, cari bagian yang berlabel upgradableDatabaseVersions.
   3. Setiap subbagian menampilkan versi database yang tersedia untuk upgrade. Di setiap subbagian, tinjau kolom berikut.
   • name: string versi database yang menyertakan versi utama dan versi minor database yang dapat Anda targetkan untuk upgrade langsung versi minor Cloud SQL untuk MySQL.

   REST v1

   Untuk memeriksa versi minor database yang tersedia untuk upgrade langsung, gunakan metode instances.get Cloud SQL Admin API.

   Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

   • INSTANCE_NAME: Nama instance.

   Metode HTTP dan URL:

   GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

   Untuk mengirim permintaan, perluas salah satu opsi berikut:

   curl (Linux, macOS, atau Cloud Shell)

   Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login , atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

   Jalankan perintah berikut:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

   PowerShell (Windows)

   Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

   Jalankan perintah berikut:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

   Anda akan menerima respons JSON seperti berikut:

   
   upgradableDatabaseVersions:
   
   {
     major_version: "MYSQL_8_0"
     name: "MYSQL_8_0_36"
     display_name: "MySQL 8.0.36"
   }
   
   

   REST v1beta4

   Untuk memeriksa versi minor database yang tersedia untuk upgrade langsung, gunakan metode instances.get Cloud SQL Admin API.

   Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

   • INSTANCE_NAME: Nama instance.

   Metode HTTP dan URL:

   GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

   Untuk mengirim permintaan, perluas salah satu opsi berikut:

   curl (Linux, macOS, atau Cloud Shell)

   Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login , atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

   Jalankan perintah berikut:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

   PowerShell (Windows)

   Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

   Jalankan perintah berikut:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

   Anda akan melihat respons JSON seperti berikut:

   
   upgradableDatabaseVersions:
   
   {
     major_version: "MYSQL_8_0"
     name: "MYSQL_8_0_36"
     display_name: "MySQL 8.0.36"
   }
   
   

   Untuk mengetahui daftar lengkap versi database yang didukung Cloud SQL, lihat Kebijakan versi dan versi database.

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

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

4. 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. Jika instance Anda memerlukan mulai ulang, akibatnya, instance Anda akan mengalami periode nonaktif. Instance edisi Cloud SQL Enterprise Plus mengalami periode nonaktif nyaris nol. Jika versi yang diinstal lebih tinggi dari versi yang diminta, permintaan akan ditolak.

Catatan: Update serentak, seperti mengupdate ukuran disk atau memori instance, tidak diizinkan saat mengupgrade versi minor database.

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, buat pengganti 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:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login , atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

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"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$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

Anda akan melihat respons JSON seperti berikut:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "[e-mail]",
  "insertTime": "2022-07-17T20:23:15.540Z",
  "operationType": "UPDATE",
  "name": "fa3f7304-ccf6-4d2f-a6f5-24df00000032",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://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, buat pengganti 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/sql/v1beta4/projects/PROJECT-ID/instances/INSTANCE_ID

Meminta isi JSON:

{
  "databaseVersion": "DATABASE_VERSION"
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login , atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

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/sql/v1beta4/projects/PROJECT-ID/instances/INSTANCE_ID"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$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/sql/v1beta4/projects/PROJECT-ID/instances/INSTANCE_ID" | Select-Object -Expand Content

Anda akan menerima respons JSON yang serupa seperti di bawah ini:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "[e-mail]",
  "insertTime": "2022-07-17T20:23:15.540Z",
  "operationType": "UPDATE",
  "name": "fa3f7304-ccf6-4d2f-a6f5-24df00000032",
  "targetId": "INSTANCE-ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/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.

Catatan: Saat memulihkan instance dari cadangan ke instance target, versi cadangan yang diinstal dibandingkan dengan versi yang diinstal dari instance database target. Karena MySQL 8.0 tidak mengizinkan downgrade, jika cadangan memiliki versi terinstal yang lebih besar dari target, permintaan pemulihan akan ditolak.

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