Mengonfigurasi penggabungan koneksi terkelola

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Halaman ini menjelaskan cara mengaktifkan, terhubung ke, 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, yang meningkatkan performa dan penggunaan resource.

Dengan menggunakan penggabungan koneksi terkelola, Anda dapat menskalakan beban kerja database dengan mengoptimalkan penggunaan resource dan latensi koneksi untuk instance AlloyDB Anda. Penggabungan koneksi terkelola secara dinamis menetapkan koneksi server ke permintaan masuk jika memungkinkan menggunakan penggabungan dan multiplexing. Pendekatan ini memberikan peningkatan performa, terutama untuk koneksi yang diskalakan, dengan menyerap lonjakan koneksi mendadak dan menggunakan kembali koneksi database yang ada. Alih-alih terhubung ke database tertentu, saat menggunakan penggabungan koneksi terkelola, aplikasi akan 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 berumur pendek, 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 Anda perlukan 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 yang dikelola AlloyDB mendukung opsi konfigurasi penggabungan lanjutan berikut. Anda dapat menyesuaikan penggabungan koneksi terkelola untuk memenuhi kebutuhan instance menggunakan opsi konfigurasi ini. Anda dapat menetapkan konfigurasi ini berdasarkan tingkat instance menggunakan konsol Google Cloud, gcloud CLI, atau AlloyDB API.

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 kumpulan cocok dengan konfigurasi yang dipilih. Koneksi klien kemudian diberi koneksi server yang tersedia. Koneksi server dipertahankan hingga ditutup secara eksplisit atau tidak ada aktivitas selama lebih lama dari periode waktu tunggu koneksi server tidak ada aktivitas.

Mengaktifkan penggabungan koneksi terkelola

Anda dapat mengaktifkan penggabungan koneksi terkelola untuk instance yang ada atau 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 konsol Google Cloud, Google Cloud CLI, atau AlloyDB API.

Mengaktifkan untuk instance kumpulan operasi baca baru

Untuk membuat instance kumpulan operasi baca baru dengan penggabungan koneksi terkelola yang diaktifkan, lihat Membuat instance kumpulan operasi baca. Anda dapat mengaktifkan penggabungan koneksi terkelola untuk instance menggunakan konsol Google Cloud, Google Cloud CLI, atau AlloyDB API.

Mengaktifkan untuk instance yang ada

Anda dapat mengaktifkan 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 \
  --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 kumpulan koneksi terkelola sama dengan koneksi database langsung, kecuali di port yang berbeda. Penggabungan koneksi terkelola memproses koneksi pada 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 semua koneksi ke kumpulan koneksi yang dikelola. Secara default, hanya koneksi SSL yang diterima. Untuk mengizinkan koneksi tanpa enkripsi, 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

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 informasi selengkapnya tentang opsi konfigurasi, nilai default, dan rentangnya, lihat opsi konfigurasi lanjutan.

Anda dapat mengubah opsi konfigurasi pengumpulan 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 \
    }

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 konsol Google Cloud, 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 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 \
  --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 pengelolaan kumpulan koneksi berjalan di instance Anda. Anda dapat melihat metrik ini menggunakan Metrics Explorer.

Untuk informasi selengkapnya, lihat Metrik AlloyDB.

Batasan

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

• Connection pooling terkelola tidak mendukung koneksi dengan Proxy Auth AlloyDB atau AlloyDB Language Connectors.
• Jika Anda menggunakan penggabungan koneksi terkelola dalam mode penggabungan transaksi, fitur SQL berikut tidak didukung:
  • SET/RESET
  • LISTEN
  • WITH HOLD CURSOR
  • PREPARE/DEALLOCATE
  • Tabel sementara PRESERVE/DELETE ROW
  • LOAD
  • Kunci saran tingkat sesi
  • Rencana siap pakai tingkat protokol