Menjinakkan PostgreSQL dengan PgBouncer: Resepsionis Andal untuk Koneksi Database

Jika kamu pernah mengalami PostgreSQL yang tiba-tiba lambat atau mogok karena terlalu banyak koneksi dari aplikasi, mungkin sudah waktunya kenalan dengan PgBouncer. Di blog ini, kita akan membahas analogi sederhana tentang cara kerja PgBouncer, bagaimana cara instalasinya, dan bagaimana menggunakannya untuk menjaga performa database tetap prima.

🧠 Apa itu PgBouncer?

PgBouncer adalah connection pooler untuk PostgreSQL. Tugas utamanya adalah mengatur dan menghemat koneksi database supaya aplikasi tidak langsung membanjiri PostgreSQL dengan terlalu banyak koneksi.

🍽️ PgBouncer dalam Analogi: Resepsionis Restoran Populer

Bayangkan PostgreSQL sebagai dapur restoran yang cuma bisa melayani 10 pelanggan sekaligus. Tapi kamu punya aplikasi yang membawa 100 pelanggan lapar dalam waktu bersamaan.

Kalau semua pelanggan langsung masuk ke dapur, hasilnya:

• 🔥 Dapur jadi overload
• 🐌 Layanan melambat
• 💥 Bahkan bisa crash karena “too many connections”

💡 Solusinya: Tambahkan Resepsionis (PgBouncer)

PgBouncer bertindak sebagai resepsionis di depan restoran:

• Menyambut semua pelanggan (koneksi aplikasi)
• Mengatur giliran masuk ke dapur (database)
• Memastikan dapur hanya melayani pelanggan sesuai kapasitas maksimal
• Kalau ada pelanggan yang cuma tanya hal kecil (query cepat), dia cepat banget masuk-keluar (efisien!)

Mode Operasi PgBouncer:

1. Session Pooling: Pelanggan duduk di satu meja dari awal hingga selesai makan. (satu koneksi penuh)
2. Transaction Pooling: Pelanggan hanya memesan satu menu, lalu pergi. Meja langsung dipakai pelanggan berikutnya. (lebih efisien)
3. Statement Pooling: Pelanggan hanya boleh pesan satu makanan, langsung keluar. (paling cepat dan ringan)

⚙️ Instalasi PgBouncer (Ubuntu/Linux)

1
2

sudo apt update
sudo apt install pgbouncer

Setelah instalasi, edit file konfigurasi utama biasanya berada di:

1

/etc/pgbouncer/pgbouncer.ini

Contoh konfigurasi minimal:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

[databases]
* = host=127.0.0.1 port=5432

[pgbouncer]
listen_addr = 127.0.0.1
listen_port = 6432
auth_type = md5
auth_file = /etc/pgbouncer/userlist.txt
pool_mode = transaction
max_client_conn = 100
default_pool_size = 20

Contoh isi userlist.txt yang ada di /etc/pgbouncer/userlist.txt:

1

"myuser" "md5<hash-password>"

Kamu bisa generate md5 hash dengan echo -n 'passwordmyuser' | md5sum

Setelah itu restart pgbouncer:

1
2

service pgbouncer restart
service pgbouncer status

🚀 Penggunaan: Arahkan Aplikasi Odoo ke PgBouncer

Ubah konfigurasi Odoo kamu, menjadi:

1
2
3
4
5

db_host = 127.0.0.1
db_user = myuser
db_password = mypass
db_name = mydb
db_port = 6432 //port pgbouncer 

Aplikasi sekarang akan berbicara ke PgBouncer, dan PgBouncer yang akan mengatur komunikasi ke PostgreSQL.

✅ Kapan Harus Menggunakan PgBouncer?

• Aplikasi membuka banyak koneksi ke PostgreSQL secara bersamaan
• Terjadi error “too many connections”
• Ingin meningkatkan efisiensi tanpa mengubah kode aplikasi
• Menggunakan banyak microservices atau layanan serverless

Penutup

PgBouncer adalah solusi ringan namun efektif untuk menjaga performa PostgreSQL tetap stabil dan efisien. Dengan analogi resepsionis restoran, kita bisa melihat betapa pentingnya peran PgBouncer dalam dunia nyata aplikasi dengan trafik tinggi.