Ringkasan Penggabungan Koneksi Terkelola

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

Managed Connection Pooling (MCP) memungkinkan Anda menskalakan beban kerja dengan mengoptimalkan penggunaan resource dan latensi koneksi untuk instance Cloud SQL untuk PostgreSQL menggunakan penggabungan. MCP 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, MCP terhubung ke cluster pooler, 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 MCP untuk beban kerja transaksional apa pun, MCP 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 MCP dapat sedikit lebih rendah daripada saat menggunakan koneksi langsung. Dalam hal ini, MCP menyediakan penskalaan koneksi saat jumlah koneksi sangat tinggi. Namun, untuk aplikasi yang biasanya membuat koneksi yang berjangka panjang, Anda dapat menggunakan koneksi langsung ke instance.

Untuk informasi selengkapnya tentang cara mengaktifkan MCP, lihat Mengonfigurasi Managed Connection Pooling.

Persyaratan

Untuk menggunakan MCP, 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 MCP.
  • 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.
  • MCP memerlukan nomor versi pemeliharaan minimum POSTGRES_$version.R20250302.00_04. Untuk informasi selengkapnya, lihat Pemeliharaan mandiri.

Opsi konfigurasi yang tersedia

MCP 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 MCP 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 MCP secara default.
  • SERVER_LIFETIME: waktu maksimum koneksi server tidak digunakan sebelum MCP menutupnya. Nilai default-nya adalah 3.600 detik.

Batasan

Pertimbangkan batasan berikut saat menggunakan MCP dengan instance edisi Cloud SQL Enterprise Plus:

  • Mengaktifkan MCP pada instance yang ada akan menyebabkan database dimulai ulang.
  • Saat Anda menggunakan Cloud SQL API untuk mengaktifkan, menonaktifkan, atau mengonfigurasi MCP, instance.update API tidak dapat berisi update konfigurasi instance lainnya.
  • MCP 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 MCP.

  • Jika Anda menggunakan MCP dalam mode penggabungan 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