Mengonfigurasi penggabungan koneksi terkelola

Halaman ini menjelaskan cara mengaktifkan, menghubungkan, dan memantau penggabungan koneksi terkelola di AlloyDB untuk PostgreSQL. Penggabungan koneksi terkelola adalah pola desain yang mengoptimalkan pengelolaan koneksi database dengan mempertahankan kumpulan koneksi yang telah dibuat sebelumnya. Kumpulan koneksi ini kemudian digunakan kembali oleh aplikasi, bukan membuka dan menutup koneksi untuk setiap operasi database, sehingga meningkatkan performa dan pemanfaatan resource.

Dengan menggunakan penggabungan koneksi terkelola, Anda dapat menskalakan beban kerja database dengan mengoptimalkan penggunaan resource dan latensi koneksi untuk instance AlloyDB. Penggabungan koneksi terkelola menetapkan koneksi server secara dinamis ke permintaan masuk jika memungkinkan menggunakan penggabungan dan multiplexing. Pendekatan ini memberikan peningkatan performa, 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, saat menggunakan penggabungan koneksi terkelola, aplikasi terhubung ke pooler, yang memberikan waktu koneksi yang lebih singkat dan skalabilitas untuk beban kerja baca Anda.

Meskipun Anda dapat menggunakan penggabungan koneksi terkelola untuk beban kerja transaksional apa pun, penggabungan koneksi terkelola paling cocok untuk aplikasi yang berisi lebih banyak koneksi singkat, atau aplikasi yang mungkin mengalami lonjakan koneksi.

Sebelum memulai

Anda harus terhubung ke instance menggunakan koneksi langsung. Connection pooling terkelola tidak mendukung koneksi dengan Proxy Auth AlloyDB atau AlloyDB Language Connectors.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk mengaktifkan dan menggunakan penggabungan koneksi terkelola, minta administrator untuk memberi Anda peran IAM Cloud 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 agar sesuai dengan kebutuhan instance Anda menggunakan opsi konfigurasi ini. Anda dapat menetapkan konfigurasi ini berdasarkan tingkat instance menggunakan Google Cloud konsol, gcloud CLI, atau AlloyDB API.

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

Mengaktifkan penggabungan koneksi terkelola

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

Mengaktifkan untuk instance utama baru

Untuk membuat instance utama baru dengan penggabungan koneksi terkelola yang 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 kumpulan baca baru dengan pengumpulan koneksi terkelola yang diaktifkan, lihat Membuat instance kumpulan baca. 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.

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

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

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

Menghubungkan ke penggabungan koneksi terkelola

Menghubungkan ke penggabungan koneksi terkelola sama dengan koneksi database langsung, kecuali pada port yang berbeda. Penggabungan koneksi terkelola memproses di 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

Menghubungkan 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 menyetel 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

Mengubah penggabungan koneksi terkelola untuk instance

Setelah mengaktifkan penggabungan koneksi terkelola, Anda dapat menyesuaikan opsi penggabungan koneksi terkelola untuk memenuhi kebutuhan instance Anda menggunakan opsi konfigurasi lanjutan. Opsi konfigurasi ini disebut flag penggabungan koneksi terkelola. Untuk mengetahui informasi selengkapnya tentang opsi konfigurasi, nilai default, dan rentangnya, lihat opsi konfigurasi lanjutan.

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

  gcloud alpha 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_CONNECTION \
      | --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-server-lifetime=SERVER_LIFETIME \
      | --connection-pooling-client-connection-idle-timeout=CLIENT_CONNECTION_IDLE_TIMEOUT \
    }

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

{
  "connectionPoolConfig": {
    "enabled": true,
    "flags": {
      "pool_mode": "POOL_MODE",
      "max_pool_size": "MAX_POOL_SIZE",
      "min_pool_size": "MIN_POOL_SIZE",
      "max_client_connection": "MAX_CLIENT_CONNECTION",
      "server_idle_timeout": "SERVER_IDLE_TIMEOUT",
      "query_wait_timeout": "QUERY_WAIT_TIMEOUT",
      "ignore_startup_parameters": "IGNORE_STARTUP_PARAMETERS"
    },
  }
}

Melihat status penggabungan koneksi terkelola untuk instance

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

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

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.

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

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

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

Memantau penggabungan koneksi terkelola

AlloyDB menyediakan metrik berikut untuk membantu Anda memantau cara kerja pooling koneksi terkelola di instance Anda. Anda dapat melihat metrik ini menggunakan Metrics Explorer.

Untuk mengetahui informasi selengkapnya, lihat Metrik AlloyDB.

Batasan

Batasan berikut berlaku selama rilis Pratinjau dan dapat berubah atau dihapus setelah rilis GA atau setelahnya:

• Managed connection pooling tidak mendukung koneksi dengan Proxy Auth AlloyDB atau AlloyDB Language Connectors.
• Jika Anda menggunakan penggabungan koneksi terkelola dalam mode penggabungan transaksi, maka fitur SQL berikut tidak didukung:
  • SET/RESET
  • LISTEN
  • WITH HOLD CURSOR
  • PREPARE/DEALLOCATE
  • Tabel sementara PRESERVE/DELETE ROW
  • LOAD
  • Kunci saran tingkat sesi
  • Rencana yang disiapkan di tingkat protokol
• Penggabungan koneksi terkelola tidak didukung untuk koneksi IP publik.