Upgrade di tempat

Halaman ini menjelaskan cara melakukan upgrade dan downgrade di tempat pada instance Cloud SQL.

Melakukan perubahan di tempat pada instance Cloud SQL

Anda dapat menggunakan perubahan di tempat untuk mengupgrade atau mendowngrade edisi instance Cloud SQL, jenis mesin, jenis penyimpanan, atau versi database-nya. Melakukan perubahan di tempat adalah cara termudah dan paling tidak rentan error untuk mengonfigurasi ulang instance.

Sebelum memulai

Pastikan instance Anda berjalan di PostgreSQL 12 atau yang lebih baru.

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

Perhatikan potensi perubahan penyimpanan terkait jenis mesin

Edisi yang berbeda mendukung jenis mesin yang berbeda yang menggunakan opsi penyimpanan yang berbeda. Jenis mesin C4 dan C4A berperforma tinggi menggunakan penyimpanan Hyperdisk Balanced, bukan salah satu opsi persistent disk yang digunakan oleh jenis mesin yang lebih lama.

Saat Anda mengubah edisi atau jenis mesin yang digunakan, jenis penyimpanan Anda juga dapat berubah, yang dapat menyebabkan periode nonaktif dan perubahan biaya penyimpanan. Saat beralih ke Google Cloud Hyperdisk Balanced, ada opsi konfigurasi tambahan yang dapat Anda tentukan. Untuk mengetahui informasi selengkapnya, lihat Perubahan penyimpanan.

Memahami perubahan penyimpanan log transaksi PITR

Jika Anda mengupgrade instance edisi Cloud SQL Enterprise yang menyimpan log tulis-dahulu yang digunakan untuk PITR di disk, perlu diketahui bahwa proses upgrade ke edisi Cloud SQL Enterprise Plus memindahkan lokasi penyimpanan log tersebut dari disk ke Cloud Storage. Untuk menentukan lokasi saat ini dari log write-ahead PITR untuk instance Anda, lihat Memeriksa lokasi penyimpanan log transaksi yang digunakan untuk PITR.

Untuk penjelasan lengkap tentang pengaruh upgrade di tempat terhadap lokasi write-ahead log, lihat Perubahan lokasi penyimpanan write-ahead log untuk PITR.

Mengubah edisi instance di tempatnya

Bagian ini menunjukkan cara mengubah edisi instance Cloud SQL Anda secara langsung ke atau dari edisi Cloud SQL Enterprise Plus. Edisi Cloud SQL Enterprise Plus menawarkan beberapa manfaat dan peningkatan performa yang tidak dimiliki edisi Cloud SQL Enterprise. Untuk mengetahui informasi selengkapnya tentang edisi Cloud SQL, lihat Ringkasan edisi Cloud SQL.

Upgrade ke edisi Cloud SQL Enterprise Plus memerlukan waktu beberapa menit untuk diselesaikan dan memiliki periode nonaktif nyaris nol. Beralih kembali ke edisi Cloud SQL Enterprise akan menyebabkan periode nonaktif yang lebih lama. Kedua proses tersebut tidak memerlukan perubahan pada endpoint yang terhubung ke aplikasi Anda.

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

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

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

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

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://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"
}

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

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

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"

$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

{
  "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"
}

Opsi untuk perubahan di tempat

Mengubah edisi instance Cloud SQL dapat memerlukan perubahan seri mesin, yang pada gilirannya memengaruhi jenis penyimpanannya.

Perubahan mesin

Saat mengubah edisi, Anda juga harus mengubah jenis mesin. Lihat Memilih seri mesin untuk mengetahui informasi selengkapnya tentang seri mesin yang didukung Cloud SQL.

Saat mengupgrade dari edisi Cloud SQL Enterprise ke edisi Cloud SQL Enterprise Plus, Anda dapat memilih antara seri mesin N2, C4A, dan C4.

Saat melakukan downgrade dari edisi Cloud SQL Enterprise Plus ke edisi Cloud SQL Enterprise, Anda dapat memilih antara core khusus tujuan umum, dan seri mesin N4.

Anda juga dapat mengubah jenis mesin tanpa mengubah edisi. Setelah memilih untuk mengedit instance, buka subbagian Mesin di Konfigurasi Mesin di area Sesuaikan instance Anda. Dengan menggunakan drop-down, Anda dapat memilih jenis mesin yang berbeda. Anda juga dapat memilih jumlah VCPU yang berbeda, dan mengaktifkan atau menonaktifkan cache data jika sesuai.

Untuk informasi umum lainnya, lihat juga dokumentasi Compute Engine untuk seri mesin N2, C4A, C4, dan N4.

Perubahan penyimpanan

Jika Anda beralih dari seri mesin tujuan umum atau N2 ke seri mesin N4, C4A, atau C4, penyimpanan Anda akan dimigrasikan dari Solid-state drive (SSD) ke penyimpanan Google Cloud Hyperdisk seimbang. Upgrade ini umumnya memerlukan waktu non-operasional yang minimal.

Penyimpanan Google Cloud Hyperdisk Balanced dapat disesuaikan untuk kasus penggunaan Anda dengan menetapkan hal berikut:

• Kapasitas penyimpanan
• IOPS yang disediakan
• Throughput yang disediakan

Google Cloud Hyperdisk Balanced menetapkan nilai IOPS dan throughput default serta batas berdasarkan konfigurasi instance Anda, yang mencakup jenis mesin dan kapasitas penyimpanan. Kapasitas penyimpanan membatasi nilai default, dan jenis mesin menetapkan nilai maksimum untuk IOPS dan throughput. Lihat Memilih opsi penyimpanan untuk mengetahui detailnya.

Perubahan lokasi log write-ahead 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.

Ketentuan berikut berlaku untuk perubahan lokasi:

• Proses ini memerlukan waktu sekitar durasi setelan konfigurasi transactionLogRetentionDays PITR untuk menyelesaikan peralihan ke Cloud Storage.
• Selama peralihan ke Cloud Storage, sebaiknya jangan ubah setelan konfigurasi PITR transactionLogRetentionDays. Meskipun Anda meningkatkan transactionLogRetentionDays, log tulis-sebelumnya tidak akan disimpan di disk lebih lama dari default 7 hari untuk instance edisi Cloud SQL Enterprise.

Default penyimpanan log dan cadangan edisi Cloud SQL Enterprise Plus

Beralih ke edisi Cloud SQL Enterprise tidak akan mengubah lokasi penyimpanan log transaksi yang digunakan untuk PITR. Jika instance edisi Cloud SQL Enterprise Plus menyimpan log transaksi 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, defaultnya diubah menjadi 7 hari. Konfigurasi pencadangan tidak berubah.