Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Mengonfigurasi penggabungan koneksi terkelola

Untuk menskalakan workload AlloyDB untuk PostgreSQL, menyerap lonjakan koneksi yang tiba-tiba, dan mengurangi latensi koneksi, Anda dapat mengaktifkan penggabungan koneksi terkelola. Penggabungan koneksi terkelola mempertahankan kumpulan koneksi server yang telah dibuat sebelumnya dan secara dinamis menggabungkan permintaan klien yang masuk di seluruh koneksi tersebut, alih-alih membuka dan menutup koneksi backend untuk setiap operasi database.

Alih-alih terhubung langsung ke backend database, aplikasi Anda terhubung ke pooler, yang memberikan waktu koneksi lebih singkat dan skalabilitas yang lebih baik untuk workload baca dan tulis Anda. Meskipun Anda dapat menggunakan penggabungan koneksi terkelola untuk workload transaksional apa pun, penggabungan koneksi ini paling cocok untuk aplikasi yang menggunakan koneksi berumur pendek atau mengalami lonjakan koneksi.

Sebelum memulai

Connection pooling terkelola juga mendukung koneksi dengan Proxy Auth AlloyDB atau Konektor Bahasa AlloyDB.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk mengaktifkan dan menggunakan penggabungan koneksi terkelola, minta administrator untuk memberi Anda peran IAM AlloyDB Admin (roles/alloydb.admin) di instance AlloyDB. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin alloydb.instances.update, yang diperlukan untuk mengaktifkan dan menggunakan penggabungan koneksi terkelola.

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Opsi konfigurasi lanjutan

Penggabungan koneksi terkelola AlloyDB mendukung opsi konfigurasi penggabungan lanjutan berikut. Anda dapat menyesuaikan penggabungan koneksi terkelola untuk memenuhi kebutuhan instance dengan menetapkan konfigurasi ini pada tingkat instance menggunakan konsol Google Cloud , gcloud CLI, atau AlloyDB API.

Nama konfigurasi	Deskripsi
Mode koneksi (`connection-pooling-pool-mode`)	Untuk mode koneksi, Anda dapat memilih transaksi (default) atau sesi. Transaction (`transaction`): Menggabungkan koneksi di tingkat transaksi. Koneksi server ditetapkan ke klien selama transaksi. Setelah transaksi selesai, koneksi server dimasukkan kembali ke dalam kumpulan. Sesi (`session`): Menggabungkan koneksi di tingkat sesi. Koneksi server ditetapkan ke klien selama klien tetap terhubung. Setelah klien terputus, koneksi server akan dimasukkan kembali ke dalam kumpulan.
Ukuran pool maksimum (`connection-pooling-max-pool-size`)	Ukuran maksimum kumpulan koneksi per pasangan pengguna dan database. Nilai ini dapat berkisar dari `1` hingga `262,042` koneksi, dan nilai defaultnya adalah `50` koneksi.
Ukuran pool minimum (`connection-pooling-min-pool-size`)	Ukuran minimum kumpulan koneksi. Nilai ini dapat berkisar dari `0` hingga `262,042` koneksi, dan nilai defaultnya adalah `0` koneksi.
Koneksi klien maksimum (`connection-pooling-max-client-connections`)	Jumlah maksimum koneksi klien simultan yang diizinkan. Nilai ini dapat berkisar dari `1` hingga `262,042` koneksi, dan nilai defaultnya adalah `5000` koneksi.
Waktu tunggu koneksi klien tidak ada aktivitas (`connection-pooling-client-connection-idle-timeout`)	Waktu koneksi klien tetap tidak ada aktivitas sebelum waktu tunggu habis. Nilai ini dapat berkisar dari `0` hingga `2,147,483` detik, dan nilai defaultnya adalah `0` detik.
Waktu tunggu koneksi server tidak ada aktivitas (`connection-pooling-server-idle-timeout`)	Waktu koneksi server tetap tidak ada aktivitas sebelum waktu habis. Nilai ini dapat berkisar dari `0` hingga `2,147,483` detik, dan nilai defaultnya adalah `600` detik.
Waktu tunggu kueri(dtk) (`connection-pooling-query-wait-timeout`)	Waktu tunggu kueri hingga waktu tunggu habis. Nilai ini dapat berkisar dari `0` hingga `2,147,483` detik, dan nilai defaultnya adalah `120` detik.
Pernyataan yang disiapkan maksimum (`connection-pooling-max-prepared-statements`)	Jumlah maksimum perintah pernyataan yang disiapkan yang dikirim dalam mode penggabungan transaksi. Nilai ini dapat berkisar dari `0` hingga `262,042`, dan nilai defaultnya adalah `0`.
Abaikan parameter startup (`connection-pooling-ignore-startup-parameters`)	Daftar parameter startup yang dipisahkan koma yang diabaikan oleh pooler jika tidak dilacak dalam paket startup secara default. Nilai defaultnya adalah `extra_float_digits`.
Masa aktif server (`connection-pooling-server-lifetime`)	Waktu maksimum koneksi server tidak digunakan sebelum penggabungan koneksi terkelola menutupnya. Nilai ini dapat berkisar dari `0` hingga `2,147,483` detik, dan nilai defaultnya adalah `3600` detik.
Pengguna statistik (`connection-pooling-stats-users`)	Daftar pengguna database yang dipisahkan koma yang diizinkan untuk terhubung ke konsol statistik. Parameter ini dapat dikonfigurasi menggunakan Google Cloud CLI atau AlloyDB API. Pengguna yang diberi otorisasi dapat mengakses metrik lanjutan, yang dikelola dalam database `alloydb_mcp_stats_{pooler_id}` untuk setiap pooler.

Secara default, penggabungan koneksi terkelola memulai koneksi ke server AlloyDB. Saat koneksi klien dibuat dan diautentikasi, penggabungan koneksi terkelola dapat membuat satu atau beberapa koneksi server sehingga ukuran gabungan sesuai dengan konfigurasi yang dipilih. Koneksi klien kemudian diberi koneksi server yang tersedia. Koneksi server dipertahankan hingga ditutup secara eksplisit atau tidak aktif selama lebih dari periode waktu tunggu koneksi server tidak aktif.

Saat Anda mengaktifkan penggabungan koneksi terkelola, koneksi server Proxy Auth AlloyDB juga digabungkan menggunakan pool terpisah yang hanya menyertakan koneksi gabungan dengan Proxy Auth AlloyDB yang diaktifkan.

Mengaktifkan penggabungan koneksi terkelola

Anda dapat mengaktifkan penggabungan koneksi terkelola untuk instance yang sudah ada atau baru.

Mengaktifkan untuk instance utama baru

Untuk membuat instance utama baru dengan penggabungan koneksi terkelola diaktifkan, lihat Membuat instance utama. Anda dapat mengaktifkan penggabungan koneksi terkelola untuk instance menggunakan konsolGoogle Cloud , Google Cloud CLI, atau AlloyDB API.

Mengaktifkan untuk instance kumpulan baca baru

Untuk membuat instance read pool baru dengan penggabungan koneksi terkelola yang diaktifkan, lihat Membuat instance read pool. Anda dapat mengaktifkan penggabungan koneksi terkelola untuk instance menggunakan konsolGoogle Cloud , Google Cloud CLI, atau AlloyDB API.

Mengaktifkan untuk instance yang ada

Anda dapat mengaktifkan penggabungan koneksi terkelola untuk instance yang ada menggunakan konsolGoogle Cloud , Google Cloud CLI, atau AlloyDB API.

Konsol

Buka halaman Clusters.

Buka Cluster
Klik cluster di kolom Resource name.
Di halaman Overview, buka Instances in your cluster.
Klik Edit primary atau Edit read pool.
Di bagian Managed connection pool, centang kotak Enable managed connection pool.
Opsional: Untuk mengonfigurasi opsi penggabungan koneksi terkelola, klik Advanced pooling options.

Anda dapat menyesuaikan opsi penggabungan koneksi terkelola untuk memenuhi kebutuhan instance Anda. Untuk mengetahui informasi selengkapnya, lihat Opsi konfigurasi lanjutan.
Klik Simpan perubahan.

gcloud

Guna mengaktifkan penggabungan koneksi terkelola untuk instance pool utama atau baca yang ada, gunakan perintah gcloud alloydb instances update berikut:

gcloud alloydb instances update INSTANCE_ID \
  --project=PROJECT_ID \
  --region=REGION_ID \
  --cluster=CLUSTER_ID \
  --enable-connection-pooling

Ganti kode berikut:

INSTANCE_ID: ID instance AlloyDB yang ingin Anda aktifkan penggabungan koneksi terkelolanya.
PROJECT_ID: ID project.
REGION_ID: ID region.
CLUSTER_ID: ID cluster.

Setelah mengaktifkan penggabungan koneksi terkelola, Anda dapat menyesuaikan opsi penggabungan koneksi terkelola untuk memenuhi kebutuhan instance dengan menetapkan opsi konfigurasi lanjutan. Untuk mengetahui informasi selengkapnya tentang cara menetapkan opsi konfigurasi, lihat Mengubah penggabungan koneksi terkelola untuk instance.

REST

Guna mengaktifkan penggabungan koneksi terkelola untuk instance pool utama atau baca yang ada, gunakan perintah berikut dan tetapkan connectionPoolConfig:

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: ID project.
LOCATION_ID: ID region cluster.
CLUSTER_ID: ID cluster. Nama harus diawali dengan huruf kecil dan dapat berisi huruf kecil, angka, dan tanda hubung.
INSTANCE_ID: ID instance.

Metode HTTP dan URL:

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

Meminta isi JSON:

{
  "connectionPoolConfig": {
    "enabled": true
  }
}

Terhubung ke penggabungan koneksi terkelola

Menghubungkan ke penggabungan koneksi terkelola sama dengan koneksi database langsung, kecuali pada port yang berbeda. Penggabungan koneksi terkelola memproses port 6432. Setiap pengguna yang ditambahkan ke instance AlloyDB dapat terhubung menggunakan penggabungan koneksi terkelola.

Menghubungkan menggunakan autentikasi bawaan

Contoh perintah ini menghubungkan instance AlloyDB Anda ke penggabungan koneksi terkelola menggunakan autentikasi bawaan.

psql postgresql://USERNAME:PASSWORD@IP_ADDRESS:6432/postgres

Ganti kode berikut:

USERNAME: nama pengguna database untuk terhubung dengan instance AlloyDB.
PASSWORD: sandi untuk pengguna.
IP_ADDRESS: alamat IP instance AlloyDB.

Terhubung menggunakan koneksi SSL

Mode SSL instance juga berlaku untuk koneksi apa pun ke pool koneksi terkelola. Secara default, hanya koneksi SSL yang diterima. Untuk mengizinkan koneksi yang tidak dienkripsi, gunakan perintah gcloud alloydb instances update berikut untuk menetapkan mode SSL instance ke ALLOW_UNENCRYPTED_AND_ENCRYPTED.

gcloud alloydb instances update INSTANCE_ID \
  --project=PROJECT_ID \
  --region=REGION_ID \
  --cluster=CLUSTER_ID \
  --ssl-mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED

Terhubung menggunakan autentikasi IAM

Anda dapat terhubung ke penggabungan koneksi terkelola menggunakan autentikasi IAM dengan salah satu dari dua cara berikut:

Melakukan autentikasi dengan token OAuth 2.0: gunakan gcloud CLI untuk mendapatkan token OAuth 2.0 dan menggunakannya sebagai sandi saat terhubung ke port 6432. Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi dengan token OAuth 2.0.
Melakukan autentikasi secara otomatis: gunakan Proxy Auth AlloyDB dengan flag --auto-iam-authn, atau aktifkan autentikasi IAM secara terprogram dengan Konektor Bahasa AlloyDB.

Melihat statistik tentang kumpulan koneksi terkelola

Saat mengaktifkan penggabungan koneksi terkelola di instance AlloyDB, Anda dapat terhubung ke konsol statistik bawaan untuk melihat informasi real-time dan mendetail tentang kumpulan koneksi Anda. Anda dapat mengakses konsol statistik di port 6432 melalui alamat IP pribadi menggunakan akses layanan pribadi atau Private Service Connect. Konsol statistik berguna untuk memantau koneksi aktif atau tidak aktif, memecahkan masalah waktu tunggu, dan mengoptimalkan ukuran pool.

Untuk menggunakan konsol statistik, ikuti langkah-langkah berikut:

Secara default, tidak ada pengguna database yang diizinkan untuk mengakses konsol statistik. Anda harus menggunakan Google Cloud CLI untuk menentukan pengguna database mana yang dapat terhubung, yang akan memasukkan mereka ke daftar yang diizinkan untuk akses konsol statistik.

Untuk menambahkan pengguna konsol statistik, gunakan perintah gcloud alloydb instances update:
```
gcloud alloydb instances update INSTANCE_ID \
--project=PROJECT_ID \
--region=REGION_ID \
--cluster=CLUSTER_ID \
--connection-pooling-stats-users=STATS_USERS
```
Ganti kode berikut:
- INSTANCE_ID: nama instance AlloyDB yang ingin Anda beri otorisasi kepada pengguna konsol statistik.
- STATS_USERS: daftar nama pengguna database yang dipisahkan koma.
- PROJECT_ID: ID project.
- REGION_ID: ID region.
- CLUSTER_ID: ID cluster.
Hubungkan ke instance di port 6432. Setiap instance connection pooler mempertahankan metriknya sendiri dalam database bernomor unik. Tentukan database statistik yang relevan untuk pooler yang ingin Anda pantau:
- Untuk pooler standar, gunakan alloydb_mcp_stats_POOLER_ID. ID-nya adalah 1, hingga jumlah pooler yang berjalan di instance.
- Untuk pooler Proxy Auth, gunakan alloydb_mcp_stats_authproxy_pooler1.
Catatan: Database konsol statistik pooler Proxy Auth hanya dapat dijangkau dengan menghubungkan menggunakan klien Proxy Auth.
```
psql postgresql://USERNAME:PASSWORD@IP_ADDRESS:6432/alloydb_mcp_stats_1
```
Ganti kode berikut:
- POOLER_ID: ID pooler koneksi. ID-nya adalah 1, hingga jumlah pooler yang berjalan di instance.
- USERNAME: nama pengguna database yang akan dihubungkan dengan instance AlloyDB.
- PASSWORD: sandi untuk pengguna.
- IP_ADDRESS: alamat IP instance AlloyDB. Alamat ini harus berupa alamat Private Service Connect (PSC) atau akses layanan pribadi (PSA).
Setelah terhubung, jalankan perintah SHOW yang kompatibel dengan PgBouncer untuk melihat metrik, misalnya:
- SHOW STATS;: menampilkan statistik umum untuk setiap database.
- SHOW POOLS;: mencantumkan status semua pool koneksi saat ini.
- SHOW CLIENTS;: menampilkan informasi tentang koneksi klien saat ini.

Untuk mengetahui daftar lengkap perintah yang tersedia, lihat dokumentasi PgBouncer resmi.

Mengubah penggabungan koneksi terkelola untuk instance

Setelah mengaktifkan penggabungan koneksi terkelola, Anda dapat menyesuaikan opsi penggabungan koneksi terkelola untuk memenuhi kebutuhan instance menggunakan opsi konfigurasi lanjutan. Opsi konfigurasi ini disebut flag penggabungan koneksi terkelola. Untuk mengetahui informasi selengkapnya, lihat Opsi konfigurasi lanjutan. Opsi ini juga berlaku untuk pooler Proxy Auth AlloyDB.

Anda dapat mengubah opsi konfigurasi penggabungan koneksi terkelola untuk instance yang ada menggunakan konsol Google Cloud , Google Cloud CLI, atau AlloyDB API.

Konsol

Buka halaman Clusters.

Buka Cluster
Klik cluster di kolom Resource Name.
Di halaman Overview, buka Instances in your cluster.
Klik Edit instance atau Edit read pool untuk instance yang ingin Anda ubah.
Di bagian Managed connection pool, luaskan Advanced pooling options.
Ubah opsi penggabungan lanjutan yang ingin Anda perbarui. Anda dapat mengubah opsi berikut:
- Mode koneksi
- Ukuran pool maksimum
- Ukuran pool minimum
- Koneksi klien maksimum
- Waktu tunggu koneksi klien tidak ada aktivitas
- Waktu tunggu koneksi server tidak ada aktivitas
- Waktu tunggu kueri habis
- Pernyataan yang disiapkan maksimum
- Mengabaikan parameter startup
- Masa aktif server
Klik Update instance.

gcloud

Untuk mengubah opsi konfigurasi penggabungan koneksi terkelola untuk instance yang ada, gunakan perintah gcloud alloydb instances update berikut:

  gcloud alloydb instances update INSTANCE_ID \
    --project=PROJECT_ID \
    --region=REGION_ID \
    --cluster=CLUSTER_ID \
    { \
      --connection-pooling-pool-mode=CONNECTION_MODE \
      | --connection-pooling-max-pool-size=MAX_POOL_SIZE \
      | --connection-pooling-min-pool-size=MIN_POOL_SIZE \
      | --connection-pooling-max-client-connections=MAX_CLIENT_CONNECTIONS \
      | --connection-pooling-server-idle-timeout=SERVER_IDLE_TIMEOUT_PERIOD \
      | --connection-pooling-query-wait-timeout=QUERY_WAIT_TIMEOUT_PERIOD \
      | --connection-pooling-ignore-startup-parameters=IGNORE_STARTUP_PARAMETERS \
      | --connection-pooling-max-prepared-statements=MAX_PREPARED_STATEMENTS \
      | --connection-pooling-server-lifetime=SERVER_LIFETIME \
      | --connection-pooling-client-connection-idle-timeout=CLIENT_CONNECTION_IDLE_TIMEOUT \
    }

Ganti kode berikut:

INSTANCE_ID: nama instance AlloyDB yang ingin Anda ubah opsi penggabungan koneksi terkelolanya.
PROJECT_ID: ID project.
REGION_ID: ID region.
CLUSTER_ID: ID cluster.
Anda dapat mengonfigurasi opsi berikut:
- --connection-pooling-pool-mode. Nilai ini harus berupa salah satu dari session atau transaction.
- --connection-pooling-max-pool-size
- --connection-pooling-min-pool-size
- --connection-pooling-max-client-connections
- --connection-pooling-server-idle-timeout
- --connection-pooling-query-wait-timeout
- --connection-pooling-ignore-startup-parameters
- --connection-pooling-max-prepared-statements
- --connection-pooling-server-lifetime
- --connection-pooling-client-connection-idle-timeout

REST

Untuk mengubah opsi konfigurasi penggabungan koneksi terkelola untuk instance yang ada, gunakan perintah berikut dan tetapkan connectionPoolConfig:

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: ID project.
LOCATION_ID: ID region cluster.
CLUSTER_ID: ID cluster. Nama harus diawali dengan huruf kecil dan dapat berisi huruf kecil, angka, dan tanda hubung.
INSTANCE_ID: ID instance.
Anda dapat mengonfigurasi opsi berikut:
- POOL_MODE. Nilai ini harus berupa salah satu dari session atau transaction.
- MAX_POOL_SIZE
- MIN_POOL_SIZE
- MAX_CLIENT_CONNECTIONS
- SERVER_IDLE_TIMEOUT
- QUERY_WAIT_TIMEOUT
- IGNORE_STARTUP_PARAMETERS
- MAX_PREPARED_STATEMENTS
- SERVER_LIFETIME
- CLIENT_CONNECTION_IDLE_TIMEOUT
- STATS_USERS

Metode HTTP dan URL:

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

Meminta isi JSON:

{
  "connectionPoolConfig": {
    "enabled": true,
    "flags": {
      "pool_mode": "POOL_MODE",
      "max_pool_size": "MAX_POOL_SIZE",
      "min_pool_size": "MIN_POOL_SIZE",
      "max_client_connections": "MAX_CLIENT_CONNECTIONS",
      "server_connection_idle_timeout": "SERVER_IDLE_TIMEOUT",
      "query_wait_timeout": "QUERY_WAIT_TIMEOUT",
      "ignore_startup_parameters": "IGNORE_STARTUP_PARAMETERS",
      "max_prepared_statements": "MAX_PREPARED_STATEMENTS",
      "server_lifetime": "SERVER_LIFETIME",
      "client_connection_idle_timeout": "CLIENT_CONNECTION_IDLE_TIMEOUT",
      "stats_users": "STATS_USERS"
    }
  }
}

Melihat status penggabungan koneksi terkelola untuk instance

Anda dapat melihat status penggabungan koneksi terkelola untuk instance menggunakan konsol Google Cloud , Google Cloud CLI, atau AlloyDB API.

Konsol

Buka halaman Clusters.

Buka Cluster
Klik cluster di kolom Resource Name.
Di halaman Overview, temukan instance yang ingin Anda lihat status penggabungan koneksi terkelolanya. Kolom Managed connection pooling menunjukkan apakah fitur ini diaktifkan atau dinonaktifkan.

gcloud

Untuk melihat status penggabungan koneksi terkelola untuk instance yang ada, gunakan perintah gcloud alloydb instances describe berikut:

gcloud alloydb instances describe INSTANCE_ID \
  --project=PROJECT_ID \
  --region=REGION_ID \
  --cluster=CLUSTER_ID \
  --format="value(connectionPoolConfig.enabled)"

Ganti kode berikut:

INSTANCE_ID: nama instance AlloyDB yang ingin Anda lihat status penggabungan koneksi terkelolanya.
PROJECT_ID: ID project.
REGION_ID: ID region.
CLUSTER_ID: ID cluster.

Jika penggabungan koneksi terkelola diaktifkan, respons berikut akan ditampilkan:

True

REST

Untuk melihat status penggabungan koneksi terkelola untuk instance AlloyDB Anda, gunakan perintah berikut dan cari connectionPoolConfig:

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: ID project.
LOCATION_ID: ID region cluster.
CLUSTER_ID: ID cluster. Nama harus diawali dengan huruf kecil dan dapat berisi huruf kecil, angka, dan tanda hubung.
INSTANCE_ID: ID instance.

Metode HTTP dan URL:

GET https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

Menonaktifkan penggabungan koneksi terkelola untuk instance yang ada

Anda dapat menonaktifkan penggabungan koneksi terkelola untuk instance yang ada menggunakan konsolGoogle Cloud , Google Cloud CLI, atau AlloyDB API.

Konsol

Buka halaman Clusters.

Buka Cluster
Klik cluster di kolom Resource Name.
Di halaman Overview, buka Instances in your cluster.
Klik Edit instance atau Edit read pool untuk instance yang ingin Anda nonaktifkan penggabungan koneksi terkelolanya.
Di bagian Managed connection pool, hapus centang pada kotak Enable managed connection pool.
Klik Update instance.

Catatan: Setelah Anda menonaktifkan penggabungan koneksi terkelola, semua koneksi yang dibuat ke penggabungan koneksi terkelola akan dihapus.

gcloud

Untuk menonaktifkan penggabungan koneksi terkelola untuk instance yang ada, gunakan perintah gcloud alloydb instances update berikut:

gcloud alloydb instances update INSTANCE_ID \
  --project=PROJECT_ID \
  --region=REGION_ID \
  --cluster=CLUSTER_ID \
  --no-enable-connection-pooling

Ganti kode berikut:

INSTANCE_ID: nama instance AlloyDB yang ingin Anda nonaktifkan penggabungan koneksi terkelolanya.
PROJECT_ID: ID project.
REGION_ID: ID region.
CLUSTER_ID: ID cluster.

REST

Untuk menonaktifkan penggabungan koneksi terkelola untuk instance yang ada, gunakan perintah berikut dan tetapkan connectionPoolConfig.enabled ke false:

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: ID project.
LOCATION_ID: ID region cluster.
CLUSTER_ID: ID cluster. Nama harus diawali dengan huruf kecil dan dapat berisi huruf kecil, angka, dan tanda hubung.
INSTANCE_ID: ID instance.

Metode HTTP dan URL:

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

Meminta isi JSON:

{
  "connectionPoolConfig": {
    "enabled": false
  }
}

Memantau penggabungan koneksi terkelola

AlloyDB menyediakan metrik berikut untuk membantu Anda memantau cara penggabungan koneksi terkelola berjalan di instance Anda. Setiap metrik diberi label dengan ID pooler. Anda dapat melihat metrik ini menggunakan Metrics Explorer.

Nama metrik	Deskripsi
Jumlah kumpulan koneksi `/database/conn_pool/num_pools`	Jumlah total kumpulan koneksi per database.
Koneksi klien `/database/conn_pool/client_connections`	Melacak jumlah koneksi klien yang dikelompokkan menurut status koneksi klien per database. Status yang disertakan dalam metrik ini adalah: `active`: jumlah koneksi aktif per database, termasuk klien tidak ada aktivitas yang tidak memiliki permintaan kueri yang tertunda. `waiting`: jumlah klien yang menunggu koneksi server per database.
Koneksi server `/database/conn_pool/server_connections`	Melacak jumlah koneksi server yang dikelompokkan berdasarkan status koneksi server per database. Status yang disertakan dalam metrik ini adalah: `active`: jumlah koneksi aktif per database. `idle`: jumlah koneksi server nonaktif per database.
Waktu tunggu rata-rata `/database/conn_pool/client_connections_avg_wait_time`	Waktu rata-rata yang dihabiskan oleh semua klien dalam status menunggu server dalam mikrodetik per database.

Untuk mengetahui informasi selengkapnya, lihat Metrik AlloyDB.

Batasan

Batasan berikut berlaku:

Jika Anda menggunakan penggabungan koneksi terkelola dalam mode penggabungan transaksi, fitur SQL berikut tidak didukung:
- SET/RESET
- LISTEN
- WITH HOLD CURSOR
- PREPARE/DEALLOCATE
- PRESERVE/DELETE ROW tabel sementara
- LOAD
- Kunci penasihat tingkat sesi
- Rencana yang disiapkan di tingkat protokol
Penggabungan koneksi terkelola tidak didukung untuk koneksi IP publik.
Koneksi dari pengguna dengan peran PostgreSQL REPLICATION tidak didukung.

Mengonfigurasi penggabungan koneksi terkelola Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Sebelum memulai

Peran yang diperlukan

Opsi konfigurasi lanjutan

Mengaktifkan penggabungan koneksi terkelola

Mengaktifkan untuk instance utama baru

Mengaktifkan untuk instance kumpulan baca baru

Mengaktifkan untuk instance yang ada

Konsol

gcloud

REST

Terhubung ke penggabungan koneksi terkelola

Menghubungkan menggunakan autentikasi bawaan

Terhubung menggunakan koneksi SSL

Terhubung menggunakan autentikasi IAM

Melihat statistik tentang kumpulan koneksi terkelola

Mengubah penggabungan koneksi terkelola untuk instance

Konsol

gcloud

REST

Melihat status penggabungan koneksi terkelola untuk instance

Konsol

gcloud

REST

Menonaktifkan penggabungan koneksi terkelola untuk instance yang ada

Konsol

gcloud

REST

Memantau penggabungan koneksi terkelola

Batasan

Mengonfigurasi penggabungan koneksi terkelola