Membuat dan mengelola kumpulan baca

Halaman ini menjelaskan cara membuat dan mengelola kumpulan baca untuk workload baca besar Anda.

Sebelum memulai

  1. Kumpulan baca berisi salinan instance utama. Jika belum melakukannya, buat instance utama edisi Cloud SQL Enterprise Plus. Meskipun kumpulan baca mendukung konektivitas IP publik, untuk tujuan panduan ini, buat instance utama dengan konektivitas IP pribadi (PSA). Untuk mengetahui informasi selengkapnya tentang instance utama dan replikasi, lihat Tentang replikasi di Cloud SQL.
  2. Setelah instance utama dibuat, pilih sandi untuk pengguna root dan jalankan perintah berikut untuk menyetel sandi di instance utama. Simpan sandi ini untuk digunakan nanti saat terhubung ke kumpulan baca.
    3.     gcloud --project=PROJECT \
    sql users set-password root --host=% \
    --instance=PRIMARY_INSTANCE_NAME --prompt-for-password

    Lakukan penggantian berikut:

    • PROJECT: nama project tempat Anda ingin menempatkan instance utama dan kumpulan baca.
    • PRIMARY_INSTANCE_NAME: nama instance utama.

Membuat kumpulan baca

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.

Gunakan perintah gcloud sql instances create berikut untuk membuat kumpulan baca dengan beberapa node kumpulan baca:

      gcloud sql instances create READ_POOL_NAME \
      --tier=TIER --edition=ENTERPRISE_PLUS \
      --instance-type=READ_POOL_INSTANCE --node-count=NODE_COUNT \
      --master-instance-name=PRIMARY_INSTANCE_NAME

Lakukan penggantian berikut:

  • READ_POOL_NAME: nama yang ingin Anda gunakan untuk kumpulan baca.
  • TIER: jenis mesin yang ingin Anda gunakan untuk setiap node kumpulan baca di kumpulan baca, seperti db-perf-optimized-N-4.
  • NODE_COUNT: jumlah node pool baca yang Anda inginkan di pool baca. Pilih angka apa pun dari 1 hingga 20.
  • PRIMARY_INSTANCE_NAME: nama instance utama yang terkait dengan kumpulan baca, seperti my-primary-instance.

Terraform

Untuk membuat kumpulan baca, gunakan resource Terraform. Kemudian, tetapkan atribut instance_type ke "READ_POOL_INSTANCE" dan atribut node_count ke jumlah node yang ingin Anda gunakan.

Contoh berikut mencakup resource untuk instance utama dan kumpulan baca. 


resource "google_sql_database_instance" "primary" {
  name             = "mysql-primary"
  database_version = "MYSQL_8_4"
  region           = "europe-west4"

  instance_type = "CLOUD_SQL_INSTANCE"

  settings {
    tier    = "db-perf-optimized-N-2"
    edition = "ENTERPRISE_PLUS"

    backup_configuration {
      enabled            = true
      binary_log_enabled = true
    }

    ip_configuration {
      ipv4_enabled = true
    }
  }
}

resource "google_sql_database_instance" "replica" {
  name             = "mysql-replica"
  database_version = "MYSQL_8_4"
  region           = "europe-west4"

  master_instance_name = google_sql_database_instance.primary.name
  instance_type        = "READ_POOL_INSTANCE"
  node_count           = 2

  settings {
    tier    = "db-perf-optimized-N-2"
    edition = "ENTERPRISE_PLUS"

    ip_configuration {
      ipv4_enabled = true
    }
  }
}

Menerapkan perubahan

Untuk menerapkan konfigurasi Terraform di project Trusted Cloud , selesaikan langkah-langkah di bagian berikut.

Menyiapkan Cloud Shell

  1. Luncurkan Cloud Shell.

  2. Tetapkan project default Trusted Cloud tempat Anda ingin menerapkan konfigurasi Terraform.

    Anda hanya perlu menjalankan perintah ini sekali per project, dan dapat dijalankan di direktori mana pun.

    export GOOGLE_CLOUD_PROJECT=PROJECT_ID

    Variabel lingkungan akan diganti jika Anda menetapkan nilai eksplisit dalam file konfigurasi Terraform.

Menyiapkan direktori

Setiap file konfigurasi Terraform harus memiliki direktorinya sendiri (juga disebut modul root).

  1. Di Cloud Shell, buat direktori dan file baru di dalam direktori tersebut. Nama file harus memiliki ekstensi .tf—misalnya main.tf. Dalam tutorial ini, file ini disebut sebagai main.tf. 
    mkdir DIRECTORY && cd DIRECTORY && touch main.tf

  2. Jika mengikuti tutorial, Anda dapat menyalin kode contoh di setiap bagian atau langkah.

    Salin kode contoh ke dalam main.tf yang baru dibuat.

    Atau, salin kode dari GitHub. Tindakan ini direkomendasikan jika cuplikan Terraform adalah bagian dari solusi menyeluruh.

  3. Tinjau dan ubah contoh parameter untuk diterapkan pada lingkungan Anda.
  4. Simpan perubahan Anda.
  5. Lakukan inisialisasi Terraform. Anda hanya perlu melakukan ini sekali per direktori. 
    terraform init

    Secara opsional, untuk menggunakan versi penyedia Google terbaru, sertakan opsi -upgrade: 

    terraform init -upgrade

Menerapkan perubahan

  1. Tinjau konfigurasi dan pastikan resource yang akan dibuat atau diupdate oleh Terraform sesuai yang Anda inginkan: 
    terraform plan

    Koreksi konfigurasi jika diperlukan.

  2. Terapkan konfigurasi Terraform dengan menjalankan perintah berikut dan memasukkan yes pada prompt: 
    terraform apply

    Tunggu hingga Terraform menampilkan pesan "Apply complete!".

  3. Buka Trusted Cloud project Anda untuk melihat hasilnya. Di konsol Trusted Cloud , buka resource Anda di UI untuk memastikan bahwa Terraform telah membuat atau mengupdatenya.

Menghapus perubahan

Untuk menghapus perubahan Anda, lakukan langkah-langkah berikut:

  1. Untuk menonaktifkan perlindungan penghapusan, di file konfigurasi Terraform Anda, tetapkan argumen deletion_protection ke false. 
    deletion_protection =  "false"
  2. Terapkan konfigurasi Terraform dengan menjalankan perintah berikut dan memasukkan yes pada prompt: 
    terraform apply

  1. Hapus resource yang sebelumnya diterapkan dengan konfigurasi Terraform Anda dengan menjalankan perintah berikut dan memasukkan yes pada prompt:

    terraform destroy

REST v1

Gunakan metode insert dari resource instance untuk membuat kumpulan baca dengan beberapa node kumpulan baca. Properti databaseVersion harus sama dengan properti utama.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT: nama project tempat Anda ingin menempatkan instance utama dan kumpulan baca.
  • REGION: region untuk kumpulan baca, seperti us-east1. Region harus sama dengan instance utama.
  • TIER: jenis mesin yang ingin Anda gunakan untuk setiap node kumpulan baca di kumpulan baca, seperti db-perf-optimized-N-4.
  • PRIMARY_INSTANCE_NAME: nama instance utama.
  • READ_POOL_NAME: nama yang ingin Anda gunakan untuk kumpulan baca, seperti my-read-pool.
  • DATABASE_VERSION: versi database yang ingin Anda gunakan. Contoh, MYSQL_8_0_37.
  • NODE_COUNT: jumlah node pool baca yang Anda inginkan di pool baca. Pilih angka apa pun dari 1 hingga 20.
  • FULL_NETWORK_NAME: jalur jaringan lengkap tempat Anda ingin pool baca berada, seperti projects/vpc-host-project/global/networks/my-network-name.

Metode HTTP dan URL: 

POST https://sqladmin.googleapis.com/v1/projects/PROJECT/instances

Meminta isi JSON: 

{
  "name": "READ_POOL_NAME",
  "masterInstanceName": "PRIMARY_INSTANCE_NAME",
  "project": "PROJECT",
  "databaseVersion": "DATABASE_VERSION",
  "region": "REGION",
  "instanceType": "READ_POOL_INSTANCE",
  "nodeCount": NODE_COUNT,
  "settings": {
    "tier": "TIER",
    "edition": "ENTERPRISE_PLUS",
    "ipConfiguration": {
      "ipv4Enabled": false,
      "privateNetwork": "FULL_NETWORK_NAME"
    }
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

REST v1beta4

Gunakan metode insert dari resource instance untuk membuat kumpulan baca dengan beberapa node kumpulan baca. Properti databaseVersion harus sama dengan properti utama.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT: nama project tempat Anda ingin menempatkan instance utama dan kumpulan baca.
  • REGION: region untuk kumpulan baca, seperti us-east1. Region harus sama dengan instance utama.
  • TIER: jenis mesin yang ingin Anda gunakan untuk setiap node kumpulan baca di kumpulan baca, seperti db-perf-optimized-N-4.
  • PRIMARY_INSTANCE_NAME: nama instance utama.
  • READ_POOL_NAME: nama yang ingin Anda gunakan untuk kumpulan baca, seperti my-read-pool.
  • DATABASE_VERSION: versi database yang ingin Anda gunakan. Contoh, MYSQL_8_0_37.
  • NODE_COUNT: jumlah node pool baca yang Anda inginkan di pool baca. Pilih angka apa pun dari 1 hingga 20.
  • FULL_NETWORK_NAME: jalur jaringan lengkap tempat Anda ingin pool baca berada, seperti projects/vpc-host-project/global/networks/my-network-name.

Metode HTTP dan URL: 

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances

Meminta isi JSON: 

{
  "name": "READ_POOL_NAME",
  "masterInstanceName": "PRIMARY_INSTANCE_NAME",
  "project": "PROJECT",
  "databaseVersion": "DATABASE_VERSION",
  "region": "REGION",
  "instanceType": "READ_POOL_INSTANCE",
  "nodeCount": NODE_COUNT,
  "settings": {
    "tier": "TIER",
    "edition": "ENTERPRISE_PLUS",
    "ipConfiguration": {
      "ipv4Enabled": false,
      "privateNetwork": "FULL_NETWORK_NAME"
    }
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

Mengonversi replika baca menjadi kumpulan baca

Anda dapat mengonversi replika baca edisi Cloud SQL Enterprise Plus yang ada menjadi kumpulan baca dengan menentukan jumlah node dalam kumpulan. Selama proses konversi ini, IP replika akan menjadi IP kumpulan baca (endpoint baca), sehingga klien yang ada dapat terhubung ke kumpulan tanpa perlu mengonfigurasi ulang.

Node kumpulan baca yang baru dibuat akan memiliki jenis dan konfigurasi mesin yang sama dengan replika baca asli. Mengubah jenis atau konfigurasi mesin ini memerlukan operasi terpisah. Operasi ini hanya didukung untuk replika baca zonal. Untuk mengonversi replika baca dengan ketersediaan tinggi (HA) menjadi kumpulan baca, Anda harus mengonversinya terlebih dahulu menjadi replika baca zonal.

Untuk mengetahui informasi selengkapnya, lihat Mengedit konfigurasi kumpulan baca.

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.

Gunakan perintah gcloud sql instances patch berikut untuk mengonversi replika baca agar dapat digunakan dengan kumpulan baca:

      gcloud sql instances patch READ_REPLICA_NAME \
      --instance-type=READ_POOL_INSTANCE --node-count=NODE_COUNT

Lakukan penggantian berikut:

  • READ_REPLICA_NAME: nama replika baca yang ingin Anda konversi.
  • NODE_COUNT: jumlah node pool baca yang Anda inginkan di pool baca. Pilih angka apa pun dari 1 hingga 20.

Terraform

Untuk mengonversi replika baca menjadi kumpulan baca, gunakan resource Terraform. Manifesnya terlihat mirip dengan yang Anda gunakan di Membuat replika baca. Kemudian, selesaikan langkah-langkah berikut:

  • Ubah atribut instance_type dari "READ_REPLICA_INSTANCE" menjadi "READ_POOL_INSTANCE" dan atribut node_count menjadi jumlah node yang ingin Anda gunakan.
  • Jika Anda telah menyetelnya sebelumnya, hapus atribut settings.availability_type.

REST v1

Gunakan metode patch dari resource instance untuk mengonversi replika baca menjadi kumpulan baca.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • READ_REPLICA_NAME: nama replika baca yang ingin Anda konversi, seperti my-read-replica.
  • NODE_COUNT: jumlah node pool baca yang Anda inginkan di pool baca. Pilih angka apa pun dari 1 hingga 20.

Metode HTTP dan URL: 

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_REPLICA_NAME

Meminta isi JSON: 

{
  "instanceType": "READ_POOL_INSTANCE",
  "nodeCount": NODE_COUNT
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

REST v1beta4

Gunakan metode patch dari resource instance untuk mengonversi replika baca menjadi kumpulan baca.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • READ_REPLICA_NAME: nama replika baca yang ingin Anda konversi, seperti my-read-replica.
  • NODE_COUNT: jumlah node pool baca yang Anda inginkan di pool baca. Pilih angka apa pun dari 1 hingga 20.

Metode HTTP dan URL: 

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_REPLICA_NAME

Meminta isi JSON: 

{
  "instanceType": "READ_POOL_INSTANCE",
  "nodeCount": NODE_COUNT
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

Mengonversi kumpulan baca menjadi replika baca

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.

Gunakan perintah gcloud sql instances patch berikut untuk mengonversi replika baca agar dapat digunakan dengan kumpulan baca:

      gcloud sql instances patch READ_POOL_NAME \
      --instance-type=READ_REPLICA_INSTANCE --availability-type=ZONAL

Lakukan penggantian berikut:

  • READ_POOL_NAME: nama kumpulan baca yang ingin Anda konversi.

Terraform

Untuk mengonversi kumpulan baca menjadi replika baca, gunakan resource Terraform. Manifesnya akan terlihat mirip dengan yang Anda gunakan di Membuat kumpulan baca. Kemudian, ubah atribut instance_type dari "READ_POOL_INSTANCE" menjadi "READ_REPLICA_INSTANCE", hapus atribut node_count, dan tetapkan atribut settings.availability_type ke ZONAL.

REST v1

Gunakan metode patch dari resource instance untuk mengonversi kumpulan baca menjadi replika baca.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • READ_POOL_NAME: nama pool baca, seperti my-read-pool.

Metode HTTP dan URL: 

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME

Meminta isi JSON: 

{
  "instanceType": "READ_REPLICA_INSTANCE",
  "settings": {
    "availabilityType": "ZONAL"
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

REST v1beta4

Gunakan metode patch dari resource instance untuk mengonversi kumpulan baca menjadi replika baca.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • READ_POOL_NAME: nama pool baca, seperti my-read-pool.

Metode HTTP dan URL: 

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME

Meminta isi JSON: 

{
  "instanceType": "READ_REPLICA_INSTANCE",
  "settings": {
    "availabilityType": "ZONAL"
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

Melihat informasi kumpulan baca

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.

Gunakan perintah gcloud sql instances describe berikut untuk menjelaskan kumpulan baca:

      gcloud sql instances describe READ_POOL_NAME

Lakukan penggantian berikut:

  • READ_POOL_NAME: nama pool baca yang ingin Anda deskripsikan.

Contoh respons dengan alamat IP dan informasi node mungkin terlihat mirip dengan berikut ini:

      ...
      connectionName: my-project:us-central1:read-pool
      ipAddresses:
      - ipAddress: 10.3.0.108
        type: PRIVATE
      nodeCount: 2
      nodes:
      - dnsName: c5bdacb09ffc.j10o8yqc7pve.us-central1.sql.goog.
        gceZone: us-central1-f
        ipAddresses:
        - ipAddress: 10.3.0.112
          type: PRIVATE
        name: read-pool-node-01
        state: RUNNABLE
      - dnsName: 8f77c454d6b2.j10o8yqc7pve.us-central1.sql.goog.
        gceZone: us-central1-c
        ipAddresses:
        - ipAddress: 10.3.0.113
          type: PRIVATE
        name: read-pool-node-02
        state: RUNNABLE

REST v1

Gunakan metode get untuk melihat detail kumpulan baca.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT: nama project tempat kumpulan baca berada.
  • READ_POOL_NAME: nama pool baca, seperti my-read-pool.

Metode HTTP dan URL: 

GET https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME

Untuk mengirim permintaan, perluas salah satu opsi berikut:

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

REST v1beta4

Gunakan metode get untuk melihat detail kumpulan baca.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT: nama project tempat kumpulan baca berada.
  • READ_POOL_NAME: nama pool baca, seperti my-read-pool.

Metode HTTP dan URL: 

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME

Untuk mengirim permintaan, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  [...],
  "connectionName": "my-project:us-central1:read-pool",
  "ipAddresses": [
    {
      "type": "PRIVATE",
      "ipAddress": "10.3.0.108"
    }
  ],
  "nodeCount": 2,
  "nodes": [
    {
      "ipAddresses": [
        {
          "type": "PRIVATE",
          "ipAddress": "10.3.0.112"
        }
      ],                                                                                                                 
      "name": "read-pool-node-01",
      "gceZone": "us-central1-f",
      "dnsName": "c5bdacb09ffc.j10o8yqc7pve.us-central1.sql.goog.",
      "state": "RUNNABLE"
    },
    {
      "ipAddresses": [
        {
          "type": "PRIVATE",
          "ipAddress": "10.3.0.113"
        }
      ],
      "name": "read-pool-node-02",
      "gceZone": "us-central1-c",
      "dnsName": "8f77c454d6b2.j10o8yqc7pve.us-central1.sql.goog.",
      "state": "RUNNABLE"
    }
  ]
}

Menambahkan atau menghapus node pool baca

Langkah-langkah berikut menskalakan kumpulan baca masuk atau keluar dengan mengubah jumlah node kumpulan baca dalam kumpulan baca. Beberapa batasan operasi berlaku. Untuk mengetahui informasi selengkapnya, lihat Batasan pool baca.

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.

Gunakan perintah gcloud sql instances patch berikut untuk menskalakan kumpulan baca:

      gcloud sql instances patch READ_POOL_NAME \
      --node-count=NODE_COUNT

Lakukan penggantian berikut:

  • READ_POOL_NAME: nama pool baca.
  • NODE_COUNT: jumlah node pool baca yang Anda inginkan di pool baca. Pilih angka apa pun dari 1 hingga 20.

Terraform

Untuk mengubah jumlah node pool baca, perbarui resource Terraform yang ada. Manifesnya akan terlihat mirip dengan yang Anda gunakan di Membuat kumpulan baca. Kemudian, ubah atribut node_count ke jumlah node yang ingin Anda gunakan.

REST v1

Gunakan metode patch untuk menskalakan kumpulan baca secara vertikal atau horizontal dengan mengubah jumlah node kumpulan baca dalam kumpulan baca.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT: nama project tempat kumpulan baca berada.
  • NODE_COUNT: jumlah node pool baca yang Anda inginkan di pool baca. Pilih angka apa pun dari 1 hingga 20.

Metode HTTP dan URL: 

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME

Meminta isi JSON: 

{
  "nodeCount": NODE_COUNT
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

REST v1beta4

Gunakan metode patch untuk menskalakan kumpulan baca secara vertikal atau horizontal dengan mengubah jumlah node kumpulan baca dalam kumpulan baca.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT: nama project tempat kumpulan baca berada.
  • NODE_COUNT: jumlah node pool baca yang Anda inginkan di pool baca. Pilih angka apa pun dari 1 hingga 20.

Metode HTTP dan URL: 

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME

Meminta isi JSON: 

{
  "nodeCount": NODE_COUNT
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

Mengedit konfigurasi kumpulan baca

Langkah-langkah berikut menunjukkan cara mengedit konfigurasi kumpulan baca. Untuk mengetahui informasi yang lebih mendetail, lihat Tentang setelan instance dan Mengedit instance.

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.

Gunakan perintah gcloud sql instances patch berikut untuk menskalakan kumpulan baca secara vertikal, misalnya, dengan mengubah jenis mesin:

      gcloud sql instances patch READ_POOL_NAME \
      --tier=TIER

Lakukan penggantian berikut:

  • READ_POOL_NAME: nama pool baca.
  • TIER: jenis mesin yang ingin Anda terapkan ke setiap node kumpulan baca di kumpulan baca, seperti db-perf-optimized-N-8.

Terraform

Untuk mengedit konfigurasi kumpulan baca, perbarui resource Terraform yang ada. Manifesnya akan terlihat mirip dengan yang Anda gunakan di Membuat kumpulan baca. Kemudian, perbarui atribut yang ingin Anda ubah di kolom settings. Misalnya, ubah atribut settings.tier ke jenis mesin yang berbeda.

REST v1

Gunakan metode patch untuk mengubah konfigurasi node pool baca. Setelan diterapkan secara seragam di semua node kumpulan baca dalam kumpulan baca.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT: nama project tempat kumpulan baca berada.
  • TIER: jenis mesin yang ingin Anda gunakan untuk setiap node kumpulan baca di kumpulan baca, seperti db-perf-optimized-N-4.
  • READ_POOL_NAME: nama pool baca, seperti my-read-pool.

Metode HTTP dan URL: 

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME

Meminta isi JSON: 

{
  "settings": {
    "tier": "TIER"
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

REST v1beta4

Gunakan metode patch untuk mengubah konfigurasi node pool baca. Setelan diterapkan secara seragam di semua node kumpulan baca dalam kumpulan baca.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT: nama project tempat kumpulan baca berada.
  • TIER: jenis mesin yang ingin Anda gunakan untuk setiap node kumpulan baca di kumpulan baca, seperti db-perf-optimized-N-4.
  • READ_POOL_NAME: nama pool baca, seperti my-read-pool.

Metode HTTP dan URL: 

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME

Meminta isi JSON: 

{
  "settings": {
    "tier": "TIER"
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

Menghubungkan ke kumpulan baca

Ada banyak cara untuk terhubung ke kumpulan baca. Langkah-langkah berikut menunjukkan salah satu cara, yaitu terhubung ke kumpulan baca dengan alamat IP pribadi dengan membuat VM di jaringan VPC yang sama untuk berfungsi sebagai sumber koneksi.

Untuk mengetahui informasi selengkapnya tentang cara lain yang dapat Anda gunakan untuk mengonfigurasi konektivitas ke instance Cloud SQL, lihat Tentang koneksi Cloud SQL. Metode koneksi biasanya mengharuskan Anda mendapatkan alamat IP atau nama koneksi instance terlebih dahulu, seperti yang dijelaskan dalam Melihat informasi kumpulan baca. Kumpulan baca mendukung sebagian besar metode koneksi yang tersedia untuk instance Cloud SQL lainnya, dengan beberapa batasan.

Jika terhubung menggunakan Proxy Auth Cloud SQL atau Cloud SQL Connectors, pastikan untuk mengupdate ke versi terbaru. Untuk dukungan kumpulan baca, versi minimum yang diperlukan mencakup berikut ini:

  • Proxy Auth Cloud SQL: v2.15.2
  • Cloud SQL Python Connector: v1.18.0
  • Konektor Go Cloud SQL: v1.16.0
  • Konektor Node Cloud SQL: v1.7.0
  • Cloud SQL Java Connector: v1.24.0

Konsol

Untuk terhubung ke kumpulan baca, selesaikan langkah-langkah berikut:

  1. Di konsol Trusted Cloud , buka halaman Instance Cloud SQL.

    Buka Instance Cloud SQL

    Anda akan diarahkan ke halaman Ringkasan instance. Klik kumpulan baca baru untuk melihat detailnya, termasuk alamat IP pribadinya. Di bagian Connect to this instance, salin dan simpan Connection name instance. connection name menggunakan format projectID:region:instanceID. Anda akan menggunakan connection name ini nanti saat memulai Proxy Auth Cloud SQL.
  2. Membuat VM Compute Engine.
  3. Buka dua koneksi SSH ke VM Compute Engine. Variabel ini digunakan pada langkah-langkah berikutnya untuk menjalankan Proxy Auth Cloud SQL dan menjalankan klien database.
  4. Instal klien.
  5. Instal Proxy Auth Cloud SQL.
  6. Mulai Proxy Auth Cloud SQL.
  7. Hubungkan ke instance Cloud SQL Anda..

Untuk mengetahui informasi selengkapnya, lihat Menghubungkan ke instance Cloud SQL dengan IP pribadi.

Menghapus kumpulan bacaan

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.

Gunakan perintah gcloud sql instances delete berikut untuk menghapus pool baca:

      gcloud sql instances delete READ_POOL_NAME

Lakukan penggantian berikut:

  • READ_POOL_NAME: nama kumpulan baca yang ingin Anda hapus.

REST v1

Gunakan metode delete untuk menghapus kumpulan baca.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT: nama project tempat kumpulan baca berada.
  • READ_POOL_NAME: nama pool baca, seperti my-read-pool.

Metode HTTP dan URL: 

DELETE https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME

Untuk mengirim permintaan, perluas salah satu opsi berikut:

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

REST v1beta4

Gunakan metode delete untuk menghapus kumpulan baca.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT: nama project tempat kumpulan baca berada.
  • READ_POOL_NAME: nama pool baca, seperti my-read-pool.

Metode HTTP dan URL: 

DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME

Untuk mengirim permintaan, perluas salah satu opsi berikut:

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

Langkah berikutnya