Mengupgrade instance ke arsitektur jaringan baru

MySQL   |  PostgreSQL   |  SQL Server

Halaman ini menjelaskan cara mengupgrade instance Cloud SQL Anda 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 harus mengupgrade arsitektur jaringan Cloud SQL untuk instance tersebut.

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 dan dari AlloyDB untuk PostgreSQL ke Cloud SQL menggunakan Database Migration Service	Mengharuskan Anda mengonfigurasi alamat IP pribadi untuk migrasi	Tidak perlu konfigurasi jaringan tambahan. Misalnya, migrasi Cloud SQL ke AlloyDB untuk PostgreSQL atau AlloyDB untuk migrasi PostgreSQL ke Cloud SQL.
Hubungkan instance Cloud SQL Anda 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
Kuota instance Cloud SQL default per project	100	1.000

Merencanakan upgrade

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

• Upgrade arsitektur jaringan Anda akan mengakibatkan periode nonaktif database selama sekitar dua menit.

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

• Jika selama empat hari terakhir atau kurang, ada dua instance atau lebih di jaringan Anda di region yang sama, Anda hanya dapat mengupgrade instance yang memiliki ketersediaan tinggi aktif.

  Catatan: Dalam skenario ini, Cloud SQL menggunakan rentang /24 ekstra untuk sementara guna menghosting instance yang diupgrade pada arsitektur baru. Setelah Cloud SQL mengupgrade semua instance dalam kombinasi jaringan dan region, Cloud SQL akan merilis rentangnya.

  Misalnya, jika jaringan Anda berisi dua instance dan satu di us-east1 dan yang satunya di us-central1, Anda dapat mengupgrade kedua instance, terlepas dari apakah ketersediaan tinggi diaktifkan atau tidak. Namun, jika jaringan Anda berisi tiga instance dan satu instance berada di us-east1 dan dua instance lainnya berada di us-central1, Anda dapat mengupgrade instance di us-central1 yang mengaktifkan ketersediaan tinggi. Karena instance di us-east1 adalah satu-satunya instance di region tersebut, Anda dapat melakukan upgrade, terlepas dari apakah ketersediaan tinggi diaktifkan atau tidak.

• Setelah mengupgrade instance ketersediaan tinggi ke arsitektur jaringan baru, Anda tidak dapat menonaktifkan ketersediaan tinggi pada instance tersebut.

• Instance ketersediaan tinggi (HA) lama dengan replika failover tidak didukung untuk upgrade.

• Setelah mengupgrade arsitektur jaringan, Anda tidak dapat membuat replika failover dengan ketersediaan tinggi (HA) lama untuk instance yang telah diupgrade.

• Jika pemulihan point-in-time (PITR) atau replikasi diaktifkan untuk instance Cloud SQL Anda setelah 11 Agustus 2023, Anda tidak dapat mengupgrade instance. Hal ini karena setelah 11 Agustus 2023, log PITR disimpan di Cloud Storage.

Merencanakan untuk mengupgrade semua instance Cloud SQL di project jaringan

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

Jika setidaknya satu instance Cloud SQL dalam project jaringan menggunakan arsitektur jaringan lama, maka seluruh project akan menggunakan arsitektur jaringan lama. Dalam hal ini, project Anda tidak sepenuhnya diupgrade ke arsitektur jaringan baru.

Anda dapat menggunakan gcloud CLI atau Cloud SQL Admin API untuk mengkueri arsitektur jaringan untuk semua instance Cloud SQL dalam sebuah project.

Saat mengubah jaringan pribadi instance atau mengaktifkan IP pribadi untuk sebuah instance, Anda tidak dapat mengubah arsitektur jaringan dalam permintaan yang sama. Jika Anda melakukannya, permintaan akan ditolak. Untuk menghindari hal ini, sebaiknya Anda mengupgrade semua instance dalam project jaringan sebelum mengubah project jaringan.

Mengupgrade arsitektur jaringan Cloud SQL Anda

Untuk mengupgrade arsitektur jaringan instance Cloud SQL Anda, lakukan langkah berikut:

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

Memeriksa arsitektur jaringan dari 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 dari 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
   ...
   sql_network_architecture: OLD_NETWORK_ARCHITECTURE
  

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

   name: INSTANCE_NAME
   project: PROJECT_ID
   ...
   sql_network_architecture: NEW_NETWORK_ARCHITECTURE
  

Parameter sql_network_architecture 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 dari 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 CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke CLI gcloud. Anda dapat memeriksa akun yang aktif saat ini 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 CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang aktif saat ini 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 dari 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 CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke CLI gcloud. Anda dapat memeriksa akun yang aktif saat ini 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 CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang aktif saat ini 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 sebuah project, gunakan perintah gcloud sql instances list atau metode instance.list.

gcloud

Untuk memeriksa arsitektur jaringan beberapa instance dalam sebuah 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 sebuah 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 CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke CLI gcloud. Anda dapat memeriksa akun yang aktif saat ini 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 CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang aktif saat ini 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 sebuah 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 CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke CLI gcloud. Anda dapat memeriksa akun yang aktif saat ini 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 CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang aktif saat ini 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 dari instance Cloud SQL tunggal

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 sekitar beberapa menit.

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

operation_id

REST v1

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

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

Selama upgrade, operasi yang berjalan lama dimulai, dan token operasi 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 CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke CLI gcloud. Anda dapat memeriksa akun yang aktif saat ini 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 CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang aktif saat ini 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 dari Cloud SQL Admin API.

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

Selama upgrade, operasi yang berjalan lama dimulai, dan token operasi berikut 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/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 CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke CLI gcloud. Anda dapat memeriksa akun yang aktif saat ini 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/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang aktif saat ini 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/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 berisi jawaban atas pertanyaan umum (FAQ) tentang mengupgrade arsitektur jaringan Cloud SQL Anda.

Apa dampak upgrade terhadap instance Cloud SQL saya?

Saat mengupgrade arsitektur jaringan Anda, instance Cloud SQL memiliki status PERAWATAN. Dalam status ini, instance mengalami periode nonaktif hingga tiga menit dan perubahan tambahan pada instance tidak diizinkan hingga upgrade selesai. Instance lain dalam project atau jaringan Anda tidak akan terpengaruh oleh upgrade.

Apakah semua fitur berfungsi sama setelah upgrade?

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

Instance mana yang menggunakan arsitektur jaringan lama?

Setiap project baru yang dibuat setelah Agustus 2021 akan otomatis menggunakan arsitektur jaringan baru. Project yang sudah 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 di 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 melakukan hal berikut:

1. Update semua instance yang ada dalam project tersebut ke arsitektur jaringan yang baru.

2. Jika Anda memiliki kontrak dukungan Google Cloud, buat permintaan dukungan untuk mengubah arsitektur jaringan default project ke arsitektur baru.

3. Jika Anda tidak memiliki kontrak dukungan, buat instance, lalu upgrade ke arsitektur jaringan baru.

Setelah default project diubah, Anda dapat membuat instance dengan arsitektur jaringan baru dalam project tersebut.

Jika Anda tidak mengubah arsitektur jaringan default project, semua instance baru dalam project tersebut akan menggunakan arsitektur jaringan lama. Kemudian, Anda harus mengupgrade setiap instance ini satu per satu ke arsitektur jaringan yang baru.

Apakah mungkin untuk mengupdate semua instance dalam sebuah project dengan satu perintah?

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

Apakah replika akan otomatis diupgrade jika saya mengupgrade yang utama?

Tidak, upgrade ke arsitektur jaringan baru didasarkan pada setiap instance. Setiap replika diperlakukan sebagai instance terpisah dan harus diupgrade secara terpisah. Artinya, jika jaringan 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.

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