Mengupgrade instance ke arsitektur jaringan baru

MySQL   |  PostgreSQL   |  SQL Server

Halaman ini menjelaskan cara mengupgrade instance Cloud SQL dari arsitektur jaringan lama ke arsitektur jaringan baru.

Halaman upgrade arsitektur jaringan Cloud SQL ini hanya berlaku untuk beberapa instance Cloud SQL. Jika instance Cloud SQL Anda menggunakan project jaringan Virtual Private Cloud (VPC) yang dibuat sebelum Agustus 2021, Anda perlu mengupgrade arsitektur jaringan Cloud SQL untuk instance Anda.

Ringkasan

Tabel berikut menunjukkan manfaat arsitektur jaringan baru dibandingkan dengan arsitektur jaringan lama:

Kemampuan	Arsitektur jaringan lama	Arsitektur jaringan baru
Bermigrasi dari Cloud SQL ke AlloyDB untuk PostgreSQL menggunakan Database Migration Service	Memerlukan Anda untuk mengonfigurasi alamat IP pribadi untuk migrasi	Tidak diperlukan konfigurasi jaringan tambahan. Misalnya, migrasi Cloud SQL ke AlloyDB untuk PostgreSQL.
Menghubungkan instance Cloud SQL menggunakan IP pribadi ke layanan pribadi seperti Cloud Build atau Vertex AI	Tidak didukung karena intransitivitas peering jaringan	Didukung
Instance yang mematuhi Assured Workloads	Tidak didukung	Didukung
Microsoft AD Terkelola	Tidak didukung	Didukung
Private Service Connect	Tidak didukung	Didukung
Penggunaan rentang alamat IP	Rentang alamat IP tambahan yang digunakan untuk subnet khusus untuk instance IP pribadi Cloud SQL untuk PostgreSQL	Tidak ada rentang alamat IP tambahan yang digunakan untuk instance Cloud SQL untuk PostgreSQL
Kuota instance Cloud SQL default per project	100	1000

Merencanakan upgrade

Sebelum mengupgrade arsitektur jaringan instance Cloud SQL, rencanakan upgrade sesuai dengan batasan upgrade berikut:

• Jika Anda mengupgrade arsitektur jaringan, Anda dapat mengalami periode nonaktif pada instance hingga rata-rata 4 menit.

• Jika ada migrasi data yang sedang berlangsung, Anda tidak dapat mengupgrade instance sumber ke arsitektur baru selama migrasi data.

• Jika Anda terhubung ke instance dari sumber eksternal, verifikasi bahwa semua koneksi peering telah diperbarui untuk mengaktifkan ekspor rute kustom.

• Jika Anda menggunakan perimeter layanan, verifikasi bahwa project host VPC Bersama disertakan. Jika project ini tidak disertakan, migrasi akan gagal.

• Anda tidak dapat mengupgrade arsitektur jaringan instance di jaringan dengan lebih dari 300 instance Cloud SQL.

• Jika jaringan Anda memiliki dua atau lebih instance yang menggunakan alamat IP pribadi di region yang sama, Cloud SQL harus menggunakan rentang /24 tambahan (atau rentang) dari rentang alamat IP akses layanan pribadi yang dialokasikan untuk menghosting instance di arsitektur jaringan yang baru. Penggunaan rentang subnet tambahan ini bersifat sementara, dan akan dihapus saat peristiwa pemeliharaan Cloud SQL berikutnya berlangsung.

Merencanakan untuk mengupgrade semua instance Cloud SQL dalam project jaringan

Instance Cloud SQL Anda dapat berada di project yang sama dengan jaringan VPC atau di project terpisah. Project yang menghosting jaringan VPC adalah project jaringan.

Project jaringan dapat beroperasi dalam mode stack ganda, yang berarti project tersebut dapat menghosting instance Cloud SQL secara bersamaan, menggunakan arsitektur jaringan lama dan baru. Hal ini terjadi jika setidaknya satu instance dalam project menggunakan arsitektur lama. Akibatnya, Cloud SQL tidak dapat mengupgrade project ke arsitektur baru.

Untuk membuat kueri arsitektur jaringan untuk semua instance dalam project, Anda dapat menggunakan gcloud CLI atau API.

Pertimbangan untuk project stack ganda

Saat menggunakan project stack ganda, perhatikan pertimbangan berikut:

• Mengupgrade instance secara implisit: Saat Anda mengubah jaringan pribadi instance atau mengaktifkan alamat IP pribadi dalam project dual stack, Cloud SQL dapat mengupgrade instance ke arsitektur jaringan baru secara implisit.
• Tidak ada downgrade arsitektur: Perubahan jaringan tidak pernah mendowngrade arsitektur jaringan instance.
• Menolak permintaan: Jika perubahan jaringan memerlukan downgrade untuk diselesaikan, Cloud SQL akan menolak permintaan tersebut.

Untuk menghindari potensi konflik dan memastikan upgrade jaringan berjalan lancar, sebaiknya Anda berencana mengupgrade semua instance dalam project ke arsitektur baru.

Mengupgrade arsitektur jaringan Cloud SQL

Untuk mengupgrade arsitektur jaringan instance Cloud SQL, lakukan hal berikut:

1. Periksa arsitektur jaringan satu instance Cloud SQL atau beberapa instance Cloud SQL.
2. Mengupgrade arsitektur jaringan instance Cloud SQL.

Memeriksa arsitektur jaringan satu instance Cloud SQL

Untuk memeriksa arsitektur jaringan saat ini dari satu instance, gunakan perintah gcloud sql instances describe atau metode instances.get.

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 arsitektur jaringan satu instance, jalankan perintah berikut:

   gcloud sql instances describe INSTANCE_NAME
   

Jika instance menggunakan arsitektur jaringan lama, responsnya akan mirip dengan berikut ini:

   name: INSTANCE_NAME
   project: PROJECT_ID
   ...
   sqlNetworkArchitecture: OLD_NETWORK_ARCHITECTURE
  

Jika instance menggunakan arsitektur jaringan baru, responsnya akan mirip dengan berikut ini:

   name: INSTANCE_NAME
   project: PROJECT_ID
   ...
   sqlNetworkArchitecture: NEW_NETWORK_ARCHITECTURE
  

Parameter sqlNetworkArchitecture menunjukkan apakah instance Anda menggunakan arsitektur jaringan lama (OLD_NETWORK_ARCHITECTURE) atau arsitektur jaringan baru (NEW_NETWORK_ARCHITECTURE).

REST v1

Untuk memeriksa arsitektur jaringan instance, gunakan metode instances.get Cloud SQL Admin API.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: Project ID.
• INSTANCE_NAME: Nama instance.
• NETWORK_ARCHITECTURE_TYPE: Jenis arsitektur jaringan ditentukan sebagai berikut:
  • OLD_NETWORK_ARCHITECTURE: Instance menggunakan arsitektur jaringan lama.
  • NEW_NETWORK_ARCHITECTURE: Instance menggunakan arsitektur jaringan baru.

Metode HTTP dan URL:

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

Meminta isi JSON:

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

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 GET \
     -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_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.

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 GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "kind": sql#instance
  "name": INSTANCE_NAME
  "project": PROJECT_ID
  "sqlNetworkArchitecture": enum (SqlNetworkArchitecture)
  ...
}

REST v1beta4

Untuk memeriksa arsitektur jaringan instance, gunakan metode instances.get Cloud SQL Admin API.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: Project ID.
• INSTANCE_NAME: Nama instance.
• NETWORK_ARCHITECTURE_TYPE: Jenis arsitektur jaringan ditentukan sebagai berikut:
  • OLD_NETWORK_ARCHITECTURE: Instance menggunakan arsitektur jaringan lama.
  • NEW_NETWORK_ARCHITECTURE: Instance menggunakan arsitektur jaringan baru.

Metode HTTP dan URL:

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

Meminta isi JSON:

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

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 GET \
     -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_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.

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 GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "kind": sql#instance
  "name": INSTANCE_NAME
  "project": PROJECT_ID
  "sqlNetworkArchitecture": enum (SqlNetworkArchitecture)
  ...
}

Memeriksa arsitektur jaringan beberapa instance Cloud SQL

Untuk memeriksa arsitektur jaringan beberapa instance dalam project, gunakan perintah gcloud sql instances list atau metode instance.list.

gcloud

Untuk memeriksa arsitektur jaringan beberapa instance dalam project, jalankan perintah berikut:

gcloud sql instances list --show-sql-network-architecture

Output-nya terlihat mirip dengan ini:

NAME        DATABASE_VERSION LOCATION   ...     SQL_NETWORK_ARCHITECTURE
instance_1  POSTGRES_13      asia-northeast1-b  OLD_NETWORK_ARCHITECTURE
instance_2  MYSQL_5_7        europe-west1-d     NEW_NETWORK_ARCHITECTURE
...

REST v1

Untuk memeriksa arsitektur jaringan beberapa instance dalam project, gunakan metode instance.list.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: Project ID.
• NETWORK_ARCHITECTURE_TYPE: Jenis arsitektur jaringan sebagai berikut:
  • OLD_NETWORK_ARCHITECTURE: Instance menggunakan arsitektur jaringan lama.
  • NEW_NETWORK_ARCHITECTURE: Instance menggunakan arsitektur jaringan baru.

Metode HTTP dan URL:

LIST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances

Meminta isi JSON:

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

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 LIST \
     -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"

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 LIST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "kind": sql#instance
  "name": INSTANCE_NAME
  "project": PROJECT_ID
  "sqlNetworkArchitecture": enum (SqlNetworkArchitecture)
  ...
}

REST v1beta4

Untuk memeriksa arsitektur jaringan beberapa instance dalam project, gunakan metode instance.list.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: Project ID.
• NETWORK_ARCHITECTURE_TYPE: Jenis arsitektur jaringan ditentukan sebagai berikut:
  • OLD_NETWORK_ARCHITECTURE: Instance menggunakan arsitektur jaringan lama.
  • NEW_NETWORK_ARCHITECTURE: Instance menggunakan arsitektur jaringan baru.

Metode HTTP dan URL:

LIST https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances

Meminta isi JSON:

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

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 LIST \
     -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"

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 LIST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "kind": sql#instance
  "name": INSTANCE_NAME
  "project": PROJECT_ID
  "sqlNetworkArchitecture": enum (SqlNetworkArchitecture)
  ...
}

Mengupgrade arsitektur jaringan satu instance Cloud SQL

Untuk mengupgrade arsitektur jaringan untuk satu instance, gunakan perintah gcloud sql instances patch, metode instance.update, atau metode instance.patch.

gcloud

Untuk mengupgrade arsitektur jaringan instance, jalankan perintah berikut:

gcloud sql instances patch INSTANCE_NAME --upgrade-sql-network-architecture

Operasi upgrade memerlukan waktu beberapa menit.

Selama upgrade, operasi yang berjalan lama akan dimulai, dan token operasi akan ditampilkan:

operation_id

REST v1

Untuk mengupgrade arsitektur jaringan instance, gunakan metode instance.update atau instance.patch Cloud SQL Admin API.

Saat Anda mengupgrade arsitektur jaringan Cloud SQL, tidak ada update tambahan ke instance yang diizinkan dalam permintaan. Isi permintaan berisi instance objek DatabaseInstance, dengan sqlNetworkArchitecture ditetapkan ke NEW_NETWORK_ARCHITECTURE.

Selama upgrade, operasi yang berjalan lama akan dimulai, dan token operasi akan ditampilkan:

operation_id

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: Project ID.
• INSTANCE_NAME: Nama instance.
• NETWORK_ARCHITECTURE_TYPE: Jenis arsitektur jaringan ditentukan sebagai berikut:
  • OLD_NETWORK_ARCHITECTURE: Instance menggunakan arsitektur jaringan lama.
  • NEW_NETWORK_ARCHITECTURE: Instance menggunakan arsitektur jaringan baru.

Metode HTTP dan URL:

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

Meminta isi JSON:

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

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

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_NAME" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "kind": sql#instance,
  "targetLink": string,
  "status": enum (SqlOperationStatus),
  "name": string,
  "insertTime": string,
  "startTime": string,
  "endTime": string
  ...
}

Jika upgrade instance Anda gagal, coba lagi operasi upgrade.

REST v1beta4

Untuk mengupgrade arsitektur jaringan instance, gunakan instance.update method atau instance.patch method Cloud SQL Admin API.

Saat Anda mengupgrade arsitektur jaringan Cloud SQL, tidak ada update tambahan ke instance yang diizinkan dalam permintaan. Isi permintaan berisi instance objek DatabaseInstance, dengan sqlNetworkArchitecture ditetapkan ke NEW_NETWORK_ARCHITECTURE.

Selama upgrade, operasi yang berjalan lama akan dimulai, dan token operasi berikut akan ditampilkan:

operation_id

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: Project ID.
• INSTANCE_NAME: Nama instance.
• NETWORK_ARCHITECTURE_TYPE: Jenis arsitektur jaringan ditentukan sebagai berikut:
  • OLD_NETWORK_ARCHITECTURE: Instance menggunakan arsitektur jaringan lama.
  • NEW_NETWORK_ARCHITECTURE: Instance menggunakan arsitektur jaringan baru.

Metode HTTP dan URL:

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

Meminta isi JSON:

{
  "sqlNetworkArchitecture": "NETWORK_ARCHITECTURE_TYPE"
}

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

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_NAME" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "kind": sql#instance,
  "targetLink": string,
  "status": enum (SqlOperationStatus),
  "name": string,
  "insertTime": string,
  "startTime": string,
  "endTime": string
  ...
}

Jika upgrade instance gagal karena alasan apa pun, Anda dapat mencoba kembali operasi upgrade.

Pertanyaan umum (FAQ)

Bagian ini memberikan jawaban atas pertanyaan umum (FAQ) tentang upgrade arsitektur jaringan Cloud SQL.

• Apa dampak upgrade pada instance Cloud SQL saya?
• Apakah semua fitur berfungsi sama setelah upgrade?
• Manakah instance yang menggunakan arsitektur jaringan lama?
• Apakah semua instance Cloud SQL baru dibuat di arsitektur jaringan baru?
• Apakah semua instance dalam project dapat diupdate dengan satu perintah?
• Apakah replika otomatis diupgrade jika saya mengupgrade replika utama?
• Saya menerima notifikasi bahwa arsitektur jaringan instance Cloud SQL saya akan diupgrade. Apa yang harus saya lakukan?
• Saat mencoba mengupgrade instance, saya menerima pesan error "di luar rentang alamat IP yang dicadangkan". Apa yang harus saya lakukan?

Apa dampak upgrade pada instance Cloud SQL saya?

Saat mengupgrade arsitektur jaringan, instance Cloud SQL memiliki status PEMELIHARAAN. Dalam status ini, instance mengalami periode nonaktif rata-rata hingga empat menit. Setiap perubahan tambahan pada instance tidak diizinkan hingga upgrade selesai. Instance lain dalam project atau jaringan Anda tidak dipengaruhi oleh upgrade.

Apakah semua fitur berfungsi sama setelah upgrade?

Semua fitur instance Cloud SQL Anda berfungsi sama di arsitektur baru seperti di arsitektur lama. Setelah mengupgrade instance untuk menggunakan arsitektur jaringan baru, jika Anda ingin mengalihkan jaringan instance tersebut, pastikan semua instance di jaringan tujuan juga diupgrade ke arsitektur jaringan baru.

Instance mana yang menggunakan arsitektur jaringan lama?

Setiap project baru yang dibuat setelah Agustus 2021 akan otomatis menggunakan arsitektur jaringan baru. Project yang ada dapat berisi instance Cloud SQL yang sudah lebih dari dua tahun dan masih menggunakan arsitektur jaringan lama. Oleh karena itu, semua instance dalam project yang ada harus diupgrade sebelum instance baru dalam project tersebut dapat mulai menggunakan arsitektur jaringan baru.

Apakah semua instance Cloud SQL baru dibuat di arsitektur jaringan baru?

Secara default, instance Cloud SQL baru yang dibuat dalam project yang dibuat setelah Agustus 2021 menggunakan arsitektur jaringan baru.

Jika ingin membuat instance dalam project yang dibuat sebelum Agustus 2021 dan menggunakan arsitektur jaringan baru, Anda harus mengupdate semua instance yang ada dalam project tersebut ke arsitektur jaringan baru. Jika menggunakan VPC Bersama, Anda harus mengupdate semua instance dalam project yang berpartisipasi dalam VPC Bersama.

Setelah Anda memperbarui semua instance yang ada di project, tunggu beberapa jam sebelum membuat instance apa pun di project. Instance baru yang Anda buat dalam project menggunakan arsitektur jaringan baru.

Apakah dapat memperbarui semua instance dalam project dengan satu perintah?

Tidak, upgrade ke arsitektur jaringan baru didasarkan pada setiap instance.

Apakah replika otomatis diupgrade jika saya mengupgrade replika utama?

Tidak, upgrade ke arsitektur jaringan baru didasarkan pada setiap instance. Setiap replika diperlakukan sebagai instance terpisah dan harus diupgrade secara terpisah. Artinya, jika node utama diupgrade dan replika menggunakan arsitektur jaringan lama, replika tidak akan terpengaruh. Hal sebaliknya juga berlaku. Jika Anda mengupgrade replika, replika utama tidak akan terpengaruh.

Saya menerima notifikasi bahwa arsitektur jaringan instance Cloud SQL saya akan diupgrade. Apa yang harus saya lakukan?

Anda tidak perlu melakukan tindakan apa pun.

Untuk beberapa instance, saat upgrade otomatis terjadi di jaringan pribadi, permintaan akan ditolak untuk sementara. Sebagai solusi, Anda dapat mengupgrade arsitektur jaringan instance sendiri dengan mengikuti prosedur di Mengupgrade arsitektur jaringan satu instance Cloud SQL.

Saat mencoba mengupgrade instance, saya menerima error "di luar rentang alamat IP yang dicadangkan". Apa yang harus saya lakukan?

Untuk menggunakan instance Cloud SQL dalam jaringan VPC dengan IP pribadi, alokasikan rentang alamat IP saat Anda menyiapkan akses layanan pribadi untuk jaringan VPC.

Misalnya, jika rentang alamat yang dialokasikan IP diubah atau dihapus, Anda mungkin mengalami error seperti berikut:

Network architecture upgrade not allowed for private-ip instance PROJECT_ID:INSTANCE_NAME
whose IP address range 10.0.0.0/24 is outside the reserved IP address range for
private services access. Re-allocate the IP address range for private services access and retry.

Dalam contoh ini, rentang alamat IP yang dialokasikan awal memiliki nama google-managed-services-VPC_NETWORK_NAME, dan rentang alamat IP yang dialokasikan awal adalah 10.0.0.0/16. Kemudian, Anda membuat instance dengan alamat IP pribadi 10.0.0.1. Jika rentang alamat IP google-managed-services-VPC_NETWORK_NAME dihapus, atau diperbarui untuk merujuk ke rentang 10.1.0.0/16, rentang ini tidak mencakup alamat IP pribadi instance 10.0.0.1. Setelah itu, saat mencoba mengupgrade arsitektur jaringan instance, Anda akan mengalami error outside the reserved IP address range.

Untuk mengatasi masalah ini, ikuti prosedur di Mengonfigurasi akses layanan pribadi untuk Cloud SQL. Alokasikan ulang rentang alamat IP yang menyertakan alamat IP instance Anda ke dalam rentang yang dialokasikan untuk akses layanan pribadi. Setidaknya, Anda dapat mengalokasikan rentang alamat IP yang dilaporkan dalam pesan error (dalam contoh sebelumnya, 10.0.0.0/24.)

Kemudian, coba lagi upgrade arsitektur jaringan.

Langkah selanjutnya

• Baca selengkapnya tentang Private Service Connect
• Baca selengkapnya tentang Assured Workloads
• Baca selengkapnya tentang Mengonfigurasi akses layanan pribadi untuk Cloud SQL
• Baca selengkapnya tentang Layanan migrasi database ke AlloyDB untuk PostgreSQL