Halaman ini diterjemahkan oleh Cloud Translation API.

Mengupgrade instance ke edisi Cloud SQL Enterprise Plus menggunakan upgrade langsung

MySQL | PostgreSQL | SQL Server

Halaman ini menunjukkan cara menggunakan metode upgrade langsung untuk mengupgrade instance edisi Cloud SQL Enterprise ke edisi Cloud SQL Enterprise Plus. Selain itu, artikel ini juga menjelaskan prosedur untuk mengganti instance edisi Cloud SQL Enterprise Plus ke edisi Cloud SQL Enterprise.

Mengupgrade ke edisi Cloud SQL Enterprise Plus akan memberi Anda beberapa manfaat dan peningkatan performa. Untuk informasi selengkapnya, lihat Pengantar edisi Cloud SQL untuk PostgreSQL.

Untuk mengaktifkan peningkatan ini untuk instance edisi Cloud SQL Enterprise yang sudah ada, Anda harus mengupgradenya ke edisi Cloud SQL Enterprise Plus. Proses upgrade memerlukan waktu beberapa menit untuk selesai dan memiliki downtime hampir nol. Beralih ke edisi Cloud SQL Enterprise dapat memerlukan periode nonaktif hingga 60 detik.

Selain itu, proses upgrade ini tidak mengharuskan Anda mengubah endpoint yang terhubung ke aplikasi Anda.

Sebelum memulai

Pastikan Anda menjalankan instance edisi Cloud SQL Enterprise di PostgreSQL 12 atau yang lebih baru.

Jika instance Anda menggunakan PostgreSQL versi sebelumnya, Anda harus mengupgrade instance tersebut ke PostgreSQL 12 atau yang lebih baru. Untuk informasi selengkapnya, lihat Mengupgrade versi utama database yang diterapkan.

Memeriksa lokasi penyimpanan log transaksi yang digunakan untuk PITR

Semua instance edisi Cloud SQL Enterprise Plus otomatis diaktifkan dengan pemulihan point-in-time (PITR). Jika instance edisi Cloud SQL Enterprise yang ingin Anda upgrade menyimpan log write-ahead yang digunakan untuk PITR di disk, proses upgrade ke edisi Cloud SQL Enterprise Plus akan mengalihkan lokasi penyimpanan log write-ahead dari disk ke Cloud Storage.

Sebelum mengupgrade ke edisi Cloud SQL Enterprise Plus, periksa apakah instance edisi Cloud SQL Enterprise Anda akan mengalami pengalihan lokasi penyimpanan untuk log write-ahead yang digunakan untuk PITR. Untuk mengetahui informasi selengkapnya dan petunjuk tentang cara memeriksa instance, lihat Memeriksa lokasi penyimpanan log transaksi yang digunakan untuk PITR.

Untuk mengetahui informasi selengkapnya tentang cara mengalihkan lokasi penyimpanan log transaksi dalam proses upgrade, lihat Lokasi penyimpanan log transaksi yang digunakan untuk PITR.

Mengupgrade instance ke edisi Cloud SQL Enterprise Plus

Gunakan prosedur di bagian ini untuk mengupgrade instance edisi Cloud SQL Enterprise ke edisi Cloud SQL Enterprise Plus.

Konsol

Di konsol Google Cloud, buka halaman Instance Cloud SQL.

Buka Instance Cloud SQL
Untuk membuka halaman Ringkasan instance, klik nama instance.
Klik Edit.
Di bagian Choose a Cloud SQL edition, klik Upgrade.
Di panel Upgrade to Enterprise Plus, masukkan ID instance Anda, lalu klik Upgrade edition.

Atau, Anda juga dapat mengupgrade instance dengan mengklik Upgrade di bagian Konfigurasi pada halaman Ringkasan instance.

gcloud

Contoh kode berikut menunjukkan cara mengupgrade instance ke edisi Cloud SQL Enterprise Plus:

gcloud sql instances patch INSTANCE_ID \
  --edition=enterprise-plus \
  --tier=MACHINE_TYPE \
  --project=PROJECT_ID

Opsional: Anda juga dapat mengaktifkan cache data untuk instance dengan menambahkan tanda --enable-data-cache.

Ganti kode berikut:

PROJECT_ID: project ID instance yang ingin Anda upgrade.
INSTANCE_ID: nama instance yang ingin Anda upgrade.
MACHINE_TYPE: jenis mesin instance yang ingin Anda upgrade. Untuk informasi selengkapnya tentang jenis mesin untuk edisi Cloud SQL Enterprise Plus, lihat Jenis mesin untuk instance edisi Cloud SQL Enterprise Plus.

REST

Perintah berikut mengupgrade instance Anda ke edisi Cloud SQL Enterprise dan memicu operasi mulai ulang.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: project ID instance yang ingin Anda upgrade.
INSTANCE_ID: ID instance dari instance yang ingin Anda upgrade.
MACHINE_TYPE: jenis mesin instance yang ingin Anda upgrade. Untuk informasi selengkapnya tentang jenis mesin untuk edisi Cloud SQL Enterprise Plus, lihat Jenis mesin untuk instance edisi Cloud SQL Enterprise Plus.

Opsional: Anda dapat mengaktifkan cache data dengan menetapkan parameter dataCacheEnabled sebagai true.

Metode HTTP dan URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

Meminta isi JSON:

{
  "settings": {
      "tier": "MACHINE_TYPE",
      "edition": "ENTERPRISE_PLUS",
      "dataCacheConfig": {
        "dataCacheEnabled": true
      },
  }
}

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": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

Perintah berikut mengupgrade instance Anda ke edisi Cloud SQL Enterprise dan memicu operasi mulai ulang.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: project ID instance yang ingin Anda upgrade.
INSTANCE_ID: ID instance dari instance yang ingin Anda upgrade.
MACHINE_TYPE: jenis mesin instance yang ingin Anda upgrade. Untuk informasi selengkapnya tentang jenis mesin untuk edisi Cloud SQL Enterprise Plus, lihat Jenis mesin untuk instance edisi Cloud SQL Enterprise Plus.

Opsional: Anda dapat mengaktifkan cache data dengan menetapkan parameter dataCacheEnabled sebagai true.

Metode HTTP dan URL:

PATCH https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

Meminta isi JSON:

{
  "settings": {
      "tier": "MACHINE_TYPE",
      "edition": "ENTERPRISE_PLUS",
      "dataCacheConfig": {
        "dataCacheEnabled": true
      },
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

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/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

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/v1beta4/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/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Lokasi penyimpanan log transaksi yang digunakan untuk PITR

Jika instance edisi Cloud SQL Enterprise Anda menyimpan log transaksi untuk PITR di disk, memulai proses upgrade ke edisi Cloud SQL Enterprise Plus akan mengalihkan lokasi penyimpanan log ini ke Cloud Storage.

Kondisi berikut berlaku untuk proses pengalihan lokasi:

Proses ini memerlukan waktu sekitar durasi setelan konfigurasi PITR transactionLogRetentionDays untuk menyelesaikan pengalihan ke Cloud Storage.
Selama beralih ke Cloud Storage, sebaiknya Anda tidak mengubah setelan konfigurasi PITR transactionLogRetentionDays. Meskipun Anda meningkatkan transactionLogRetentionDays, log write-ahead tidak akan disimpan di disk lebih lama dari default 7 hari untuk instance edisi Cloud SQL Enterprise.

Default penyimpanan cadangan dan log edisi Cloud SQL Enterprise Plus

Setelah upgrade ke edisi Cloud SQL Enterprise Plus selesai, periode retensi log transaksi default untuk semua instance yang diupgrade akan ditingkatkan menjadi 14 hari. Untuk peningkatan ini, dan peningkatan lainnya yang Anda konfigurasikan untuk periode retensi log transaksi, diperlukan nilai baru dan peningkatan untuk mencapai periode retensi penuh PITR. Misalnya, jika nilai lama untuk hari retensi log transaksi adalah 7 hari dan nilai baru ditingkatkan menjadi 14 hari, periode PITR untuk 7 hari pertama setelah upgrade hanya 7 hari. Pada hari ke-8, periode PITR menjadi 8 hari, pada hari ke-9 menjadi 9 hari, hingga periode retensi akhirnya ditingkatkan menjadi 14 hari pada hari ke-14.

Selain itu, jumlah default cadangan otomatis ditingkatkan dari 8 menjadi 15.

Jika Anda mengupgrade ke edisi Cloud SQL Enterprise Plus setelah melakukan upgrade versi utama, Anda tidak akan dapat melakukan PITR ke titik waktu yang terjadi sebelum upgrade versi utama. Batasan ini berlaku meskipun periode retensi Anda mencakup jangka waktu tersebut. Anda dapat memulihkan instance ke titik waktu tertentu setelah memulai upgrade versi utama.

Mengubah ke edisi Cloud SQL Enterprise

Konsol

Di konsol Google Cloud, buka halaman Instance Cloud SQL.

Buka Instance Cloud SQL
Untuk membuka halaman Ringkasan instance, klik nama instance.
Klik Edit.
Di bagian Choose a Cloud SQL edition, klik Switch to Enterprise.
Di panel Beralih ke Enterprise, masukkan ID instance Anda, lalu klik Beralih edisi.

Atau, Anda juga dapat beralih ke edisi Cloud SQL Enterprise dengan mengklik Beralih ke Enterprise di bagian Konfigurasi halaman Ringkasan instance.

gcloud

Contoh kode berikut menunjukkan cara mengubah instance ke edisi Cloud SQL Enterprise:

gcloud sql instances patch INSTANCE_ID \
  --edition=enterprise \
  --tier=MACHINE_TYPE \
  --project=PROJECT_ID

Ganti kode berikut:

PROJECT_ID: project ID instance.
INSTANCE_ID: nama instance.
MACHINE_TYPE: jenis mesin instance yang ingin Anda alihkan. Untuk informasi selengkapnya tentang jenis mesin untuk edisi Cloud SQL Enterprise, lihat Jenis mesin untuk instance edisi Cloud SQL Enterprise.

REST

Perintah berikut mengubah instance Anda ke edisi Cloud SQL Enterprise dan memicu operasi mulai ulang.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: project ID instance.
INSTANCE_ID: ID instance.
MACHINE_TYPE: jenis mesin instance yang ingin Anda alihkan. Untuk informasi selengkapnya tentang jenis mesin untuk edisi Cloud SQL Enterprise, lihat Jenis mesin untuk instance edisi Cloud SQL Enterprise.

Metode HTTP dan URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

Meminta isi JSON:

{
  "settings": {
      "tier": "MACHINE_TYPE",
      "edition": "ENTERPRISE"
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

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)

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": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

Perintah berikut mengubah instance Anda ke edisi Cloud SQL Enterprise dan memicu operasi mulai ulang.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: project ID instance.
INSTANCE_ID: ID instance.
MACHINE_TYPE: jenis mesin instance yang ingin Anda alihkan. Untuk informasi selengkapnya tentang jenis mesin untuk edisi Cloud SQL Enterprise, lihat Jenis mesin untuk instance edisi Cloud SQL Enterprise.

Metode HTTP dan URL:

PATCH https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

Meminta isi JSON:

{
  "settings": {
      "tier": "MACHINE_TYPE",
      "edition": "ENTERPRISE"
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

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/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

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/v1beta4/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/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Default penyimpanan cadangan dan log edisi Cloud SQL Enterprise

Beralih ke edisi Cloud SQL Enterprise tidak akan mengubah lokasi penyimpanan log transaksi yang digunakan untuk PITR. Jika instance edisi Cloud SQL Enterprise Plus Anda menyimpan log transaksinya untuk PITR di Cloud Storage, log tersebut akan tetap berada di Cloud Storage. Namun, alih-alih menyimpan log transaksi selama 14 hari untuk PITR secara default, default-nya diubah menjadi 7 hari. Konfigurasi pencadangan tidak diubah.

Langkah selanjutnya

Pelajari edisi Cloud SQL Enterprise Plus lebih lanjut.