Halaman ini menjelaskan cara mengonfigurasi Pengelompokan Koneksi Terkelola untuk instance Cloud SQL Anda.
Sebelum memulai
- Pastikan instance Anda memenuhi semua persyaratan untuk menggunakan Managed Connection Pooling.
- Jika Anda menggunakan gcloud CLI, gunakan perintah
gcloud beta
dan confirmasikan bahwa versi gcloud CLI Anda adalah515.0.0
atau yang lebih baru. - Pastikan instance Anda menggunakan arsitektur jaringan Cloud SQL yang baru. Jika instance Anda masih menggunakan arsitektur jaringan lama, upgrade ke arsitektur jaringan baru.
Anda dapat mengaktifkan Pengelompokan Koneksi Terkelola untuk instance pada saat pembuatan, atau mengedit instance yang ada untuk mengaktifkannya.
Mengaktifkan Penggabungan Koneksi Terkelola untuk instance baru
Untuk membuat instance dengan Penggabungan Koneksi Terkelola yang diaktifkan, lihat Membuat instance. Anda dapat mengaktifkan Pengelolaan Tampungan Koneksi untuk instance menggunakan gcloud CLI atau Cloud SQL API.
Mengaktifkan Penggabungan Koneksi Terkelola untuk instance yang ada
Anda dapat mengaktifkan Pengelompokan Koneksi Terkelola untuk instance yang ada menggunakan konsol Google Cloud, gcloud CLI, atau Cloud SQL API. Anda harus mengaktifkan Penggabungan Koneksi Terkelola sebelum mengubah opsi Penggabungan Koneksi Terkelola.
Konsol
Di konsol Google Cloud, buka halaman Instance Cloud SQL.
Temukan instance yang ingin Anda aktifkan Penggabungan Koneksi Terkelola. Untuk membuka halaman Ringkasan instance, klik nama instance.
Klik Edit.
Di bagian Customize your instance, luaskan Connections.
Untuk mengaktifkan Penggabungan Koneksi Terkelola, centang kotak Aktifkan Kumpulan Koneksi Terkelola.
Klik Simpan.
gcloud
Gunakan perintah gcloud beta sql instances
untuk mengaktifkan Penggabungan Koneksi Terkelola.
gcloud beta sql instances patch INSTANCE_NAME \
--enable-connection-pooling
Ganti kode berikut:
INSTANCE_NAME
: nama instance Cloud SQL yang ingin Anda aktifkan untuk Managed Connection Pooling.
REST v1
Untuk mengaktifkan Pengelompokan Koneksi Terkelola bagi instance yang ada, gunakan perintah berikut dan tetapkan connectionPoolingEnabled
:
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- PROJECT_ID: project ID
- INSTANCE_ID: ID instance
Metode HTTP dan URL:
PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID
Meminta isi JSON:
{ "settings": { "connectionPoolConfig": { "connectionPoolingEnabled": true } } }
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
Anda akan melihat respons JSON seperti berikut:
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID", "status": "PENDING", "user": "user@example.com", "insertTime": "2020-01-16T02:32:12.281Z", "operationType": "UPDATE", "name": "OPERATION_ID", "targetId": "INSTANCE_ID", "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID", "targetProject": "PROJECT_ID" }
REST v1beta4
Untuk mengaktifkan Pengelompokan Koneksi Terkelola bagi instance yang ada, gunakan perintah berikut dan tetapkan connectionPoolingEnabled
:
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- PROJECT_ID: project ID
- INSTANCE_ID: ID instance
Metode HTTP dan URL:
PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID
Meminta isi JSON:
{ "settings": { "connectionPoolConfig": { "connectionPoolingEnabled": true } } }
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
Anda akan melihat respons JSON seperti berikut:
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID", "status": "PENDING", "user": "user@example.com", "insertTime": "2020-01-16T02:32:12.281Z", "operationType": "UPDATE", "name": "OPERATION_ID", "targetId": "INSTANCE_ID", "selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID", "targetProject": "PROJECT_ID" }
Mengubah Penggabungan Koneksi Terkelola untuk instance
Setelah mengaktifkan Penggabungan Koneksi Terkelola, Anda dapat menyesuaikan Penggabungan Koneksi Terkelola menggunakan opsi konfigurasi yang tersedia. Opsi konfigurasi ini disebut flag kumpulan Managed Connection Pooling. Konfigurasi yang ditambahkan ke Kumpulan Koneksi Terkelola diterapkan ke semua pengumpulan yang digunakan oleh instance. Untuk informasi selengkapnya tentang opsi konfigurasi, nilai default, dan rentangnya yang tersedia, lihat opsi konfigurasi yang tersedia.
Untuk mengubah opsi konfigurasi Penggabungan Koneksi Terkelola yang tersedia untuk instance, lakukan hal berikut:
Konsol
Di konsol Google Cloud, buka halaman Instance Cloud SQL.
Temukan instance yang ingin Anda aktifkan Penggabungan Koneksi Terkelola. Untuk membuka halaman Ringkasan instance, klik nama instance.
Klik Edit.
Di bagian Customize your instance, luaskan Connections.
Di bagian Managed connection pool, luaskan Advanced pooling options.
Ubah opsi penggabungan yang tersedia yang ingin Anda perbarui.
Klik Simpan.
gcloud
Gunakan perintah gcloud beta sql instances
untuk mengubah opsi konfigurasi.
gcloud beta sql instances patch INSTANCE_NAME \
--connection-pool-flags=CONFIGURATION_NAME=CONFIGURATION_VALUE
Ganti kode berikut:
INSTANCE_NAME
: nama instance Cloud SQL yang ingin Anda ubah Pengelolaan Tampungan Koneksinya.CONFIGURATION_NAME
: nama opsi konfigurasi yang ingin Anda ubah. Untuk mengetahui daftar semua opsi konfigurasi yang tersedia, lihat opsi konfigurasi yang tersedia.CONFIGURATION_VALUE
: nilai baru untuk opsi konfigurasi yang Anda pilih.
REST v1
Untuk mengubah konfigurasi yang tersedia
Managed Connection Pooling,
gunakan perintah berikut dan tetapkan ConnectionPoolConfig
:
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- PROJECT_ID: project ID
- INSTANCE_ID: ID instance
Metode HTTP dan URL:
PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID
Meminta isi JSON:
{ "settings": { "connectionPoolConfig": { "flags": [ { "name": "CONFIGURATION_NAME", "value":"CONFIGURATION_VALUE" } ] } } }
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
Anda akan melihat respons JSON seperti berikut:
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID", "status": "PENDING", "user": "user@example.com", "insertTime": "2020-01-16T02:32:12.281Z", "operationType": "UPDATE", "name": "OPERATION_ID", "targetId": "INSTANCE_ID", "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID", "targetProject": "PROJECT_ID" }
REST v1beta4
Untuk mengubah konfigurasi yang tersedia
Managed Connection Pooling,
gunakan perintah berikut dan tetapkan ConnectionPoolConfig
:
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- PROJECT_ID: project ID
- INSTANCE_ID: ID instance
Metode HTTP dan URL:
PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID
Meminta isi JSON:
{ "settings": { "connectionPoolConfig": { "flags": [ { "name": "CONFIGURATION_NAME", "value":"CONFIGURATION_VALUE" } ] } } }
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
Anda akan melihat respons JSON seperti berikut:
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID", "status": "PENDING", "user": "user@example.com", "insertTime": "2020-01-16T02:32:12.281Z", "operationType": "UPDATE", "name": "OPERATION_ID", "targetId": "INSTANCE_ID", "selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID", "targetProject": "PROJECT_ID" }
Menonaktifkan Penggabungan Koneksi Terkelola untuk instance
Anda dapat menonaktifkan Pengelompokan Koneksi Terkelola untuk instance yang ada menggunakan Konsol Google Cloud, gcloud CLI, atau Cloud SQL API.
Untuk menonaktifkan Penggabungan Koneksi Terkelola untuk instance, lakukan langkah-langkah berikut:
Konsol
Di konsol Google Cloud, buka halaman Instance Cloud SQL.
Temukan instance yang ingin Anda nonaktifkan Pemelungan Koneksi Terkelolanya. Untuk membuka halaman Ringkasan instance, klik nama instance.
Klik Edit.
Di bagian Customize your instance, luaskan Connections.
Untuk menonaktifkan Penggabungan Koneksi Terkelola, hapus centang pada kotak Aktifkan Kumpulan Koneksi Terkelola.
Klik Simpan.
gcloud
Gunakan perintah gcloud beta sql instances
untuk menonaktifkan Penggabungan Koneksi Terkelola.
gcloud beta sql instances patch INSTANCE_NAME \
--no-enable-connection-pooling
Ganti kode berikut:
PROJECT_ID
: nama instance Cloud SQL yang ingin Anda nonaktifkan Pengelolaan Tampungan Koneksinya.
REST v1
Untuk menonaktifkan Pengelompokan Koneksi Terkelola untuk instance, gunakan perintah berikut dan tetapkan connectionPoolingEnabled
:
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- PROJECT_ID: project ID
- INSTANCE_ID: ID instance
Metode HTTP dan URL:
PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID
Meminta isi JSON:
{ "settings": { "connectionPoolConfig": { "connectionPoolingEnabled": false } } }
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
Anda akan melihat respons JSON seperti berikut:
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID", "status": "PENDING", "user": "user@example.com", "insertTime": "2020-01-16T02:32:12.281Z", "operationType": "UPDATE", "name": "OPERATION_ID", "targetId": "INSTANCE_ID", "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID", "targetProject": "PROJECT_ID" }
REST v1beta4
Untuk menonaktifkan Pengelompokan Koneksi Terkelola untuk instance, gunakan perintah berikut dan tetapkan connectionPoolingEnabled
:
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- PROJECT_ID: project ID
- INSTANCE_ID: ID instance
Metode HTTP dan URL:
PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID
Meminta isi JSON:
{ "settings": { "connectionPoolConfig": { "connectionPoolingEnabled": false } } }
Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:
Anda akan melihat respons JSON seperti berikut:
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID", "status": "PENDING", "user": "user@example.com", "insertTime": "2020-01-16T02:32:12.281Z", "operationType": "UPDATE", "name": "OPERATION_ID", "targetId": "INSTANCE_ID", "selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID", "targetProject": "PROJECT_ID" }
Melihat status Kumpulan Koneksi Terkelola untuk instance
Anda dapat melihat status Pengelompokan Koneksi Terkelola untuk instance menggunakan Konsol Google Cloud, gcloud CLI, atau Cloud SQL API.
Untuk melihat status Pengelompokan Koneksi Terkelola untuk instance edisi Cloud SQL Enterprise Plus, lakukan langkah-langkah berikut:
Konsol
Di konsol Google Cloud, buka halaman Instance Cloud SQL.
Temukan instance yang ingin Anda nonaktifkan Pemelungan Koneksi Terkelolanya. Untuk membuka halaman Ringkasan instance, klik nama instance.
Bagian Koneksi menunjukkan apakah Pengelompokan Koneksi Terkelola diaktifkan atau dinonaktifkan.
gcloud
gcloud beta sql instances describe INSTANCE_NAME| 2 connectionPoolingEnabled
Ganti kode berikut:
PROJECT_ID
: nama instance Cloud SQL yang status Pengelolaan Tampungan Koneksinya ingin Anda lihat.Jika Penggabungan Koneksi Terkelola diaktifkan, respons berikut akan ditampilkan:
connectionPoolingEnabled: true
REST v1
Untuk melihat status Pengelompokan Koneksi Terkelola untuk instance Cloud SQL Anda, gunakan perintah berikut dan cari ConnectPoolingEnabled
:
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- PROJECT_ID: ID atau nomor project project Google Cloud yang berisi instance.
- INSTANCE_NAME: nama instance Cloud SQL. Jika instance ini mengaktifkan Private Service Connect, endpoint Private Service Connect di jaringan VPC dapat terhubung ke instance tersebut.
Metode HTTP dan URL:
GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME
Untuk mengirim permintaan, perluas salah satu opsi berikut:
Anda akan menerima respons JSON seperti berikut:
{ "kind": "sql#instance", "state": "RUNNABLE", "databaseVersion": "POSTGRES_13", "settings": { "authorizedGaeApplications": [], "tier": "db-custom-2-7680", "kind": "sql#settings", "availabilityType": "REGIONAL", "pricingPlan": "PER_USE", "replicationType": "SYNCHRONOUS", "activationPolicy": "ALWAYS", "ipConfiguration": { "authorizedNetworks": [], "pscConfig": { "allowedConsumerProjects": [ "ALLOWED_PROJECTS" ], "pscEnabled": true }, "ipv4Enabled": false }, ... "createTime": "2023-06-14T18:48:34.975Z", "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE", "pscServiceAttachmentLink": "projects/PROJECT_ID/regions/REGION_NAME/serviceAttachments/SERVICE_ATTACHMENT_ID", "dnsName": "DNS_NAME" }
REST v1beta4
Untuk melihat status Pengelompokan Koneksi Terkelola untuk instance Cloud SQL Anda, gunakan perintah berikut dan cari ConnectPoolingEnabled
:
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- PROJECT_ID: ID atau nomor project project Google Cloud yang berisi instance.
- INSTANCE_NAME: nama instance Cloud SQL. Jika instance ini mengaktifkan Private Service Connect, endpoint Private Service Connect di jaringan VPC dapat terhubung ke instance tersebut.
Metode HTTP dan URL:
GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME
Untuk mengirim permintaan, perluas salah satu opsi berikut:
Anda akan melihat respons JSON seperti berikut:
{ "kind": "sql#instance", "state": "RUNNABLE", "databaseVersion": "POSTGRES_13", "settings": { "authorizedGaeApplications": [], "tier": "db-custom-2-7680", "kind": "sql#settings", "availabilityType": "REGIONAL", "pricingPlan": "PER_USE", "replicationType": "SYNCHRONOUS", "activationPolicy": "ALWAYS", "ipConfiguration": { "authorizedNetworks": [], "pscConfig": { "allowedConsumerProjects": [ "ALLOWED_PROJECTS" ], "pscEnabled": true }, "ipv4Enabled": false }, ... "createTime": "2023-06-14T18:48:34.975Z", "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE", "pscServiceAttachmentLink": "projects/PROJECT_ID/regions/REGION_NAME/serviceAttachments/SERVICE_ATTACHMENT_ID", "dnsName": "DNS_NAME" }
Memantau Penggabungan Koneksi Terkelola
Anda dapat memantau cara Pengelolaan Tampungan Koneksi berjalan di instance Cloud SQL menggunakan metrik Pengelolaan Tampungan Koneksi Cloud SQL berikut:
Nama metrik | Deskripsi |
---|---|
num_pools | Jumlah total kumpulan koneksi per database. |
client_connection | Melacak jumlah koneksi berdasarkan status koneksi
klien. Status yang disertakan dalam metrik ini adalah:
|
server_connections | Melacak jumlah koneksi server berdasarkan status koneksi server. Status yang disertakan dalam metrik ini
adalah:
|
client_connections_avg_wait_time | Waktu rata-rata yang dihabiskan oleh semua klien dalam status menunggu server. |
Untuk mengetahui informasi selengkapnya tentang metrik ini, lihat Metrik Cloud SQL. Untuk melihat metrik ini menggunakan konsol Google Cloud, lihat Melihat metrik di halaman ringkasan instance Cloud SQL.