Halaman ini diterjemahkan oleh Cloud Translation API.

Membuat dan mengelola kumpulan baca

MySQL | PostgreSQL | SQL Server

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

Sebelum memulai

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

    gcloud --project=PROJECT \
    sql users set-password root --host=% \
    --instance=PRIMARY_INSTANCE_NAME --prompt-for-password

Pastikan Anda menggunakan gcloud v516.0.0 atau yang lebih baru.

Lakukan penggantian berikut:

PROJECT: nama project tempat Anda ingin menempatkan instance primer 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 beta sql instances create berikut untuk membuat kumpulan baca dengan beberapa node kumpulan baca:

      gcloud beta 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 dalam 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.

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 primer 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 dalam pool baca. Pilih angka apa pun dari 1 hingga 20.
FULL_NETWORK_NAME: jalur jaringan lengkap tempat Anda ingin read pool 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:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan 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 POST \
     -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/instances"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan 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 POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT/instances" | Select-Object -Expand Content

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

Tanggapan

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CREATE_READ_POOL",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT/operations/OPERATION_ID",
  "targetProject": "PROJECT"
}

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 primer 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 dalam pool baca. Pilih angka apa pun dari 1 hingga 20.
FULL_NETWORK_NAME: jalur jaringan lengkap tempat Anda ingin read pool 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:

curl (Linux, macOS, atau Cloud Shell)

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X POST \
     -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/instances"

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

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

Respons

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CREATE_READ_POOL",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/operations/OPERATION_ID",
  "targetProject": "PROJECT"
}

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 beta sql instances patch berikut untuk mengonversi replika baca agar dapat digunakan dengan kumpulan baca:

      gcloud beta 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 dalam pool baca. Pilih angka apa pun dari 1 hingga 20.

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 dalam 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:

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/instances/READ_REPLICA_NAME"

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/instances/READ_REPLICA_NAME" | Select-Object -Expand Content

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

Tanggapan

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_REPLICA_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "READ_REPLICA_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT/operations/OPERATION_ID",
  "targetProject": "PROJECT"
}

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 dalam 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:

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/sql/v1beta4/projects/PROJECT/instances/READ_REPLICA_NAME"

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/sql/v1beta4/projects/PROJECT/instances/READ_REPLICA_NAME" | Select-Object -Expand Content

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

Respons

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_REPLICA_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "READ_REPLICA_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/operations/OPERATION_ID",
  "targetProject": "PROJECT"
}

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 beta sql instances patch berikut untuk mengonversi replika baca agar dapat digunakan dengan kumpulan baca:

      gcloud beta sql instances patch READ_POOL_NAME \
      --instance-type=READ_REPLICA_INSTANCE

Lakukan penggantian berikut:

READ_POOL_NAME: nama kumpulan baca yang ingin Anda konversi.

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

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/instances/READ_POOL_NAME"

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/instances/READ_POOL_NAME" | Select-Object -Expand Content

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

Tanggapan

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "READ_POOL_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT/operations/OPERATION_ID",
  "targetProject": "PROJECT"
}

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

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/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME"

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/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME" | Select-Object -Expand Content

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

Respons

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "READ_POOL_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/operations/OPERATION_ID",
  "targetProject": "PROJECT"
}

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 beta sql instances describe berikut untuk menjelaskan kumpulan baca:

      gcloud beta 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:

curl (Linux, macOS, atau Cloud Shell)

Jalankan perintah berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME"

PowerShell (Windows)

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME" | Select-Object -Expand Content

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

Tanggapan

{
  [...],
  "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"
    }
  ]
}

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:

curl (Linux, macOS, atau Cloud Shell)

Jalankan perintah berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME"

PowerShell (Windows)

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME" | Select-Object -Expand Content

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 beta sql instances patch berikut untuk menskalakan kumpulan baca:

      gcloud beta 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 dalam pool baca. Pilih angka apa pun dari 1 hingga 20.

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 dalam 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:

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/instances/READ_POOL_NAME"

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/instances/READ_POOL_NAME" | Select-Object -Expand Content

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

Tanggapan

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "READ_POOL_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT/operations/OPERATION_ID",
  "targetProject": "PROJECT"
}

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 dalam 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:

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/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME"

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/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME" | Select-Object -Expand Content

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

Respons

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAMEINSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "READ_POOL_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/operations/OPERATION_ID",
  "targetProject": "PROJECT"
}

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 beta sql instances patch berikut untuk menskalakan kumpulan baca secara vertikal, misalnya, dengan mengubah jenis mesin:

      gcloud beta 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.

REST v1

Gunakan metode patch untuk mengubah konfigurasi node kumpulan 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:

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/instances/READ_POOL_NAME"

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/instances/READ_POOL_NAME" | Select-Object -Expand Content

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

Tanggapan

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "READ_POOL_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT/operations/OPERATION_ID",
  "targetProject": "PROJECT"
}

REST v1beta4

Gunakan metode patch untuk mengubah konfigurasi node kumpulan 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:

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/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME"

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/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME" | Select-Object -Expand Content

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

Respons

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "READ_POOL_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/operations/OPERATION_ID",
  "targetProject": "PROJECT"
}

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:

Di konsol Google 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.
Membuat VM Compute Engine.
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.
Instal klien.
Instal Proxy Auth Cloud SQL.
Mulai Proxy Auth Cloud SQL.
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 kumpulan 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:

curl (Linux, macOS, atau Cloud Shell)

Jalankan perintah berikut:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME"

PowerShell (Windows)

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME" | Select-Object -Expand Content

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

Tanggapan

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "DELETE",
  "name": "OPERATION_ID",
  "targetId": "READ_POOL_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT/operations/OPERATION_ID",
  "targetProject": "PROJECT"
}

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:

curl (Linux, macOS, atau Cloud Shell)

Jalankan perintah berikut:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME"

PowerShell (Windows)

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME" | Select-Object -Expand Content

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

Tanggapan

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "DELETE",
  "name": "OPERATION_ID",
  "targetId": "READ_POOL_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/operations/OPERATION_ID",
  "targetProject": "PROJECT"
}

Langkah berikutnya

Tentang kumpulan baca

Membuat dan mengelola kumpulan baca Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Sebelum memulai

Membuat kumpulan baca

gcloud

REST v1

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

Tanggapan

REST v1beta4

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

Respons

Mengonversi replika baca menjadi kumpulan baca

gcloud

REST v1

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

Tanggapan

REST v1beta4

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

Respons

Mengonversi kumpulan baca menjadi replika baca

gcloud

REST v1

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

Tanggapan

REST v1beta4

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

Respons

Melihat informasi kumpulan baca

gcloud

REST v1

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

Tanggapan

REST v1beta4

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

Menambahkan atau menghapus node pool baca

gcloud

REST v1

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

Tanggapan

REST v1beta4

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

Respons

Mengedit konfigurasi kumpulan baca

gcloud

REST v1

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

Tanggapan

REST v1beta4

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

Respons

Menghubungkan ke kumpulan baca

Konsol

Menghapus kumpulan bacaan

gcloud

REST v1

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

Tanggapan

REST v1beta4

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

Tanggapan

Langkah berikutnya

Membuat dan mengelola kumpulan baca