Halaman ini menjelaskan cara mengaktifkan, mengonfigurasi, dan memantau Penggabungan Koneksi Terkelola di instance Cloud SQL Anda.
Penggabungan Koneksi Terkelola memungkinkan Anda menskalakan workload dengan mengoptimalkan pemanfaatan resource dan latensi koneksi untuk instance menggunakan penggabungan. Untuk mengetahui informasi mendetail tentang Penggabungan Koneksi Terkelola dan cara menggunakannya untuk instance Anda, lihat Ringkasan Penggabungan Koneksi Terkelola.
Sebelum memulai
- Pastikan instance Anda memenuhi semua persyaratan untuk menggunakan Penggabungan Koneksi Terkelola.
- Jika Anda menggunakan gcloud CLI, pastikan versi gcloud CLI Anda adalah
515.0.0atau 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.
- Pastikan instance Anda memiliki koneksi server yang diperlukan per vCPU yang dialokasikan dalam flag
max_connectionsuntuk setelan konfigurasi database Anda. Untuk informasi selengkapnya, lihat Koneksi server yang digunakan oleh Penggabungan Koneksi Terkelola.
Mengaktifkan Penggabungan Koneksi Terkelola
Anda dapat mengaktifkan Penggabungan Koneksi Terkelola untuk instance pada saat pembuatan, atau mengedit instance yang ada untuk mengaktifkannya.
Mengaktifkan Penggabungan Koneksi Terkelola untuk instance baru
Untuk membuat instance baru dengan Penggabungan Koneksi Terkelola diaktifkan, lihat Membuat instance. Anda dapat mengaktifkan Penggabungan Koneksi Terkelola untuk instance baru hanya menggunakan gcloud CLI atau Cloud SQL API.
Mengaktifkan Penggabungan Koneksi Terkelola untuk instance yang ada
Untuk mengaktifkan Penggabungan Koneksi Terkelola untuk instance yang ada, lakukan hal berikut:
Konsol
Di konsol Cloud de Confiance , 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 Enable Managed Connection Pool.
Klik Simpan.
gcloud
Gunakan perintah gcloud sql instances
untuk mengaktifkan Penggabungan Koneksi Terkelola.
gcloud sql instances patch INSTANCE_NAME \
--enable-connection-pooling
Ganti kode berikut:
INSTANCE_NAME: nama instance Cloud SQL.
REST v1
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
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 yang mirip 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"
}
Terraform
Gunakan resource Terraform berikut:
Mengubah Penggabungan Koneksi Terkelola untuk instance
Setelah mengaktifkan Managed Connection Pooling, Anda dapat menyesuaikan Managed Connection Pooling untuk memenuhi kebutuhan instance menggunakan opsi konfigurasi lanjutan. Opsi konfigurasi ini disebut flag pool Managed Connection Pooling. Konfigurasi yang ditambahkan ke Penggabungan Koneksi Terkelola diterapkan per penggabung koneksi yang digunakan oleh instance. Connection pooler adalah layanan proxy database yang mengelola connection pool antara aplikasi klien dan server database. Karena Cloud SQL menskalakan jumlah penggabung koneksi berdasarkan ukuran instance (1 penggabung koneksi untuk setiap 4 vCPU, dengan minimum 1 penggabung koneksi), tentukan nilai konfigurasi Anda berdasarkan ukuran instance dan persyaratan ukuran kumpulan. Untuk mengetahui informasi selengkapnya tentang opsi konfigurasi lanjutan, nilai default, dan rentangnya, lihat Opsi konfigurasi lanjutan.
Untuk mengubah opsi konfigurasi Managed Connection Pooling lanjutan untuk sebuah instance, lakukan hal berikut:
Konsol
Di konsol Cloud de Confiance , 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 lanjutan yang ingin Anda perbarui.
Klik Simpan.
gcloud
Gunakan perintah gcloud sql instances
untuk mengubah opsi konfigurasi.
gcloud sql instances patch INSTANCE_NAME \
--connection-pool-flags=CONFIGURATION_NAME=CONFIGURATION_VALUE
Ganti kode berikut:
INSTANCE_NAME: nama instance Cloud SQL.CONFIGURATION_NAME: nama opsi konfigurasi. Untuk mengetahui daftar semua opsi konfigurasi lanjutan, lihat Opsi konfigurasi lanjutan.CONFIGURATION_VALUE: nilai baru untuk opsi konfigurasi yang dipilih.
REST v1
Untuk mengubah Konfigurasi lanjutan Penggabungan Koneksi Terkelola, 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 lanjutan Penggabungan Koneksi Terkelola, 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 yang mirip 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"
}
Terraform
Untuk mengubah Konfigurasi lanjutan Penggabungan Koneksi Terkelola, gunakan resource Terraform berikut:
Menonaktifkan Penggabungan Koneksi Terkelola untuk instance
Anda dapat menonaktifkan Penggabungan Koneksi Terkelola untuk instance yang ada menggunakan konsolCloud de Confiance , gcloud CLI, atau Cloud SQL API.
Untuk menonaktifkan Penggabungan Koneksi Terkelola untuk sebuah instance, lakukan hal berikut:
Konsol
Di konsol Cloud de Confiance , buka halaman Instance Cloud SQL.
Temukan instance yang ingin Anda nonaktifkan Managed Connection Pooling-nya. 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 Enable Managed Connection Pool.
Klik Simpan.
gcloud
Gunakan perintah gcloud sql instances
untuk menonaktifkan Penggabungan Koneksi Terkelola.
gcloud sql instances patch INSTANCE_NAME \
--no-enable-connection-pooling
Ganti kode berikut:
PROJECT_ID: nama instance Cloud SQL.
REST v1
Untuk menonaktifkan Managed Connection Pooling 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 Managed Connection Pooling 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 yang mirip 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"
}
Terraform
Untuk menonaktifkan Managed Connection Pooling untuk instance, gunakan resource Terraform berikut:
Melihat status Penggabungan Koneksi Terkelola untuk instance
Anda dapat melihat status Penggabungan Koneksi Terkelola untuk instance menggunakan konsol Cloud de Confiance , gcloud CLI, atau Cloud SQL API.
Untuk melihat status Penggabungan Koneksi Terkelola untuk instance edisi Cloud SQL Enterprise Plus, lakukan hal berikut:
Konsol
Di konsol Cloud de Confiance , buka halaman Instance Cloud SQL.
Temukan instance yang ingin Anda lihat status Penggabungan Koneksi Terkelola-nya. Untuk membuka halaman ringkasan instance, klik nama instance.
Bagian Connections menunjukkan apakah Penggabungan Koneksi Terkelola diaktifkan atau dinonaktifkan.
gcloud
Gunakan perintah gcloud sql instances describe untuk melihat status Penggabungan Koneksi Terkelola untuk sebuah instance:
gcloud sql instances describe INSTANCE_NAME \
--format="value(settings.connectionPoolConfig.connectionPoolingEnabled)"
Ganti kode berikut:
PROJECT_ID: nama instance Cloud SQL.Jika Managed Connection Pooling diaktifkan, respons berikut akan ditampilkan:
connectionPoolingEnabled: true
REST v1
Untuk melihat status Penggabungan Koneksi Terkelola untuk instance Cloud SQL Anda, gunakan perintah berikut dan cari connectionPoolingEnabled:
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- PROJECT_ID: ID atau nomor project dari project Cloud de Confiance 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 Anda, 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 Penggabungan Koneksi Terkelola untuk instance Cloud SQL Anda, gunakan perintah berikut dan cari connectionPoolingEnabled:
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- PROJECT_ID: ID atau nomor project dari project Cloud de Confiance 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 Anda, 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 Managed Connection Pooling berjalan di instance Cloud SQL menggunakan metrik Managed Connection Pooling Cloud SQL berikut:
| Nama metrik | Deskripsi |
|---|---|
| client_connections | Melacak jumlah koneksi berdasarkan status koneksi klien. Status yang disertakan dalam metrik ini adalah:
|
| client_connections_attempts_count | Jumlah upaya koneksi klien yang diterima per kumpulan koneksi. |
| client_connections_avg_wait_time | Waktu rata-rata yang dihabiskan oleh semua klien dalam status menunggu untuk server. |
| client_connections_error_count | Jumlah error per connection pool yang menyebabkan klien terputus, termasuk error autentikasi, error penyiapan koneksi klien, dan error koneksi server. |
| num_pools | Jumlah total kumpulan koneksi per database. |
| server_connections | Melacak jumlah koneksi server berdasarkan status koneksi server. Status yang disertakan dalam metrik ini
adalah:
|
Untuk mengetahui informasi selengkapnya tentang metrik ini, lihat Metrik Cloud SQL. Untuk melihat metrik ini menggunakan konsol Cloud de Confiance , lihat Melihat metrik di halaman ringkasan instance Cloud SQL.