Ringkasan Penggabungan Koneksi Terkelola

Halaman ini menjelaskan apa yang dimaksud dengan Managed Connection Pooling dan cara menggunakannya dengan instance Cloud SQL Anda.

Kumpulan Koneksi Terkelola memungkinkan Anda menskalakan beban kerja dengan mengoptimalkan penggunaan resource dan latensi koneksi untuk instance Cloud SQL untuk PostgreSQL menggunakan pengumpulan. Penggabungan Koneksi Terkelola secara dinamis menetapkan koneksi server ke permintaan masuk jika memungkinkan. Hal ini memberikan peningkatan performa yang signifikan, terutama untuk koneksi yang diskalakan, dengan menyerap lonjakan koneksi yang tiba-tiba dan menggunakan kembali koneksi database yang ada. Alih-alih terhubung ke database tertentu, Penggabungan Koneksi Terkelola terhubung ke cluster penggabungan, yang memberikan waktu koneksi dan skalabilitas yang lebih singkat untuk beban kerja Anda. Jumlah pooler yang digunakan didasarkan pada jumlah core vCPU instance Anda.

Meskipun Anda dapat menggunakan Penggabungan Koneksi Terkelola untuk beban kerja transaksional apa pun, Penggabungan Koneksi Terkelola memberikan manfaat throughput dan latensi terbanyak dengan aplikasi yang berisi koneksi berumur pendek, atau aplikasi yang menghasilkan lonjakan koneksi.

Untuk koneksi yang berumur panjang, performa koneksi menggunakan Penggabungan Koneksi Terkelola dapat sedikit lebih rendah daripada saat menggunakan koneksi langsung. Dalam hal ini, Penggabungan Koneksi Terkelola menyediakan penskalaan koneksi saat jumlah koneksi sangat tinggi. Namun, untuk aplikasi yang biasanya membuat koneksi yang bertahan lama, Anda dapat menggunakan koneksi langsung ke instance.

Untuk mengetahui informasi selengkapnya tentang cara mengaktifkan Kumpulan Koneksi Terkelola, lihat Mengonfigurasi Kumpulan Koneksi Terkelola.

Persyaratan

Untuk menggunakan Pengelompokan Koneksi Terkelola, instance Anda harus memenuhi persyaratan berikut:

  • Instance Anda harus berupa instance edisi Cloud SQL Enterprise Plus.
  • Anda harus terhubung ke instance menggunakan koneksi langsung, atau hanya Proxy Auth Cloud SQL.
  • Anda harus terhubung ke instance menggunakan nama pengguna dan sandi yang valid. Pengguna grup IAM dan IAM tidak didukung saat menggunakan Pengelompokan Koneksi Terkelola.
  • Instance Anda harus disiapkan untuk akses layanan pribadi, menggunakan IP publik, atau merupakan instance baru dengan Private Service Connect yang diaktifkan.
  • Instance Anda harus menggunakan arsitektur jaringan Cloud SQL yang baru.
  • Penggabungan Koneksi Terkelola memerlukan nomor versi pemeliharaan minimum POSTGRES_$version.R20250302.00_04. Untuk informasi selengkapnya, lihat Pemeliharaan mandiri.

Opsi konfigurasi yang tersedia

Pooling Koneksi Terkelola menawarkan opsi penggabungan berikut yang dapat Anda tetapkan menggunakan parameter pool_mode:

  • transaction (default): menggabungkan koneksi di tingkat transaksi.
  • session: menggabungkan koneksi di tingkat sesi.

Anda juga dapat menyesuaikan Pengelompokan Koneksi Terkelola menggunakan parameter konfigurasi berikut:

  • max_pool_size: ukuran maksimum kumpulan koneksi. Nilai defaultnya adalah 50 koneksi.
  • min_pool_size: ukuran nilai minimum kumpulan koneksi. Jika jumlah koneksi server kurang dari min_pool_size, tambahkan lebih banyak koneksi server ke kumpulan. Nilai defaultnya adalah 0 koneksi.
  • max_client_connections: jumlah maksimum koneksi yang diizinkan untuk instance Anda. Nilai defaultnya adalah 5.000 koneksi.
  • 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 default-nya adalah 0 detik.
  • server_connection_idle_timeout: waktu koneksi server tetap tidak ada aktivitas sebelum waktu tunggu habis. Nilai ini dapat berkisar dari 0 hingga 2.147.483 detik, dan nilai default-nya adalah 600 detik.
  • query_wait_timeout: waktu yang ditunggu kueri hingga waktu tunggu habis. Nilai ini dapat berkisar dari 0 hingga 2.147.483 detik, dan nilai default-nya adalah 120 detik.
  • max_prepared_statements: jumlah maksimum perintah pernyataan yang disiapkan bernama tingkat protokol yang didukung dalam mode penggabungan transaksi. Nilai defaultnya adalah 0.
  • ignore_startup_parameters: parameter yang ingin Anda abaikan, yang tidak dilacak dalam paket startup Managed Connection Pooling secara default.
  • server_lifetime: waktu maksimum koneksi server tidak digunakan sebelum Managed Connection Pooling menutupnya. Nilai default-nya adalah 3.600 detik.

Batasan

Pertimbangkan batasan berikut saat menggunakan Kumpulan Koneksi Terkelola dengan instance edisi Cloud SQL Enterprise Plus Anda:

  • Mengaktifkan Penggabungan Koneksi Terkelola pada instance yang ada akan memicu mulai ulang database.
  • Saat Anda menggunakan Cloud SQL API untuk mengaktifkan, menonaktifkan, atau mengonfigurasi Pengelolaan Tampungan Koneksi, instance.update API tidak dapat berisi update konfigurasi instance lainnya.
  • Pengelompokan Koneksi Terkelola hanya dapat digunakan dengan Proxy Auth Cloud SQL versi 2.15.2 dan yang lebih baru.
  • Jika Anda menggunakan Cloud SQL Go Language Connector, sebaiknya gunakan versi Go minimum 1.24. Jika menggunakan Go versi 1.23 atau yang lebih lama, Anda mungkin akan mengalami batasan performa saat menggunakan Managed Connection Pooling.

  • Jika Anda menggunakan Pengelompokan Koneksi Terkelola dalam mode pengelompokan transaction, fitur SQL berikut tidak didukung:

    • SET/RESET
    • LISTEN
    • WITH HOLD CURSOR
    • PREPARE/DEALLOCATE
    • Tabel sementara PRESERVE/DELETE ROW
    • LOAD
    • Kunci saran tingkat sesi

  • Jika Anda menggunakan Cloud SQL untuk PostgreSQL versi 17, opsi sslnegotiation=direct tidak didukung.

Langkah berikutnya