PostgreSQL Bağlantısı

Tem 8, 2026 OP

Konuyu Açan #0

PostgreSQL Bağlantısı

Veritabanı sistemlerinin kalbi, şüphesiz ki istemcilerin sunucuya nasıl eriştiği ve bu etkileşimi nasıl sürdürdüğüdür. PostgreSQL ekosisteminde de durum farklı değil; bir uygulamanın veya kullanıcının veriyle etkileşime geçebilmesi için sağlam, güvenli ve verimli bir bağlantı kurması gerekiyor. Çoğu zaman psql komutuyla basitçe bağlanıp işlerimizi hallederiz, ancak arka planda neler olup bittiğini, bu bağlantıların nasıl yönetildiğini ve optimize edildiğini anlamak, özellikle büyük ölçekli veya kritik sistemlerde hayati önem taşır. Sadece bir veritabanı sunucusuna erişmekten çok daha fazlası var bu işte...

Bağlantı Temelleri ve Protokol

Bir PostgreSQL bağlantısı, aslında bir istemci uygulamasının (bir web sunucusu, masaüstü uygulaması, komut satırı aracı gibi) PostgreSQL sunucusuyla iletişim kurmak için başlattığı bir oturumdur. Bu iletişim genellikle TCP/IP üzerinden gerçekleşir ve PostgreSQL'in kendi wire protokolünü kullanır. Basitçe ifade etmek gerekirse, istemci belirli bir IP adresi ve port numarası üzerinden sunucuya bir bağlantı isteği gönderir. Sunucu bu isteği kabul ederse, bir dizi kimlik doğrulama adımından sonra istemciye bir oturum açar ve bu oturum boyunca SQL sorguları gönderilip sonuçlar alınabilir. Her bağlantı, sunucu tarafında belirli bir miktar kaynak (bellek, CPU) tüketir, bu da bağlantı yönetiminin neden bu kadar kritik olduğunu gösterir. Yani, rastgele bağlantı açıp kapatmak, sistem kaynaklarını gereksiz yere yorabilir, hatta performansı düşürebilir.

Bağlantı Dizileri ve Bileşenleri

PostgreSQL'e bağlanırken kullanılan "bağlantı dizisi" veya "URI", istemcinin sunucuya bağlanmak için ihtiyaç duyduğu tüm bilgileri tek bir yerde toplar. Bu diziler genellikle ana bilgisayar (host), port, veritabanı adı (dbname), kullanıcı adı (user) ve parola (password) gibi temel bileşenleri içerir. Ancak bununla da sınırlı kalmaz; SSL modları, uygulama adları ve diğer çeşitli parametreler de eklenebilir. Örneğin:

CODE

12
postgresql://kullanici:[email protected]:5432/veritabani?sslmode=require&application_name=MyApp

Burada kullanici, parola, sunucu.adres.com, 5432 (varsayılan port), veritabani ve ek olarak sslmode=require ile application_name=MyApp gibi parametreler görüyoruz. Her bir bileşen, bağlantının nasıl kurulacağı ve hangi özelliklere sahip olacağını belirler. sslmode parametresi, bağlantının güvenliği için kritik öneme sahipken, application_name gibi parametreler sunucu tarafında bağlantıları izlemeyi ve yönetmeyi kolaylaştırır. Bu parametreleri doğru yapılandırmak, hem güvenlik hem de izlenebilirlik açısından çok önemli.

Kimlik Doğrulama ve pg_hba.conf

Bir istemci sunucuya bağlanmaya çalıştığında, sunucunun ilk yaptığı şeylerden biri istemcinin kimliğini doğrulamaktır. PostgreSQL'de bu, büyük ölçüde pg_hba.conf (host-based authentication) dosyası tarafından yönetilir. Bu dosya, hangi istemcilerin hangi veritabanlarına, hangi kullanıcı adıyla ve hangi kimlik doğrulama yöntemiyle bağlanabileceğini tanımlayan bir dizi kural içerir. Her kural, bir satır olarak ifade edilir ve şu formatı izler:

CODE

12
TYPE  DATABASE  USER  ADDRESS  METHOD  [OPTIONS]

TYPE: Bağlantı türü (local (Unix socket), host (TCP/IP), hostssl (SSL kullanan TCP/IP), hostnossl (SSL kullanmayan TCP/IP)).
DATABASE: Bağlanılacak veritabanı (all, sameuser, samerole veya belirli bir veritabanı adı).
USER: Bağlanacak kullanıcı (all, samegroup veya belirli bir kullanıcı adı).
ADDRESS: İstemcinin IP adresi veya ağ aralığı.
METHOD: Kimlik doğrulama yöntemi (trust, reject, md5, scram-sha-256, password, ident, peer, gssapi, ssi, ldap, radius, cert vb.).

Örneğin, sadece belirli bir IP adresinden md5 şifreleme ile bağlanmaya izin vermek için şöyle bir kural yazılabilir:

CODE

12
host    all    all    192.168.1.10/32    md5

Veya tüm yerel bağlantılara peer kimlik doğrulamasıyla izin vermek:

CODE

12
local    all    all    peer

pg_hba.conf dosyasındaki kuralların sıralaması önemlidir; sunucu, istemcinin bağlantı isteğiyle eşleşen ilk kuralı kullanır. Bu nedenle, daha spesifik kurallar genellikle daha genel kurallardan önce gelmelidir. Bu dosya doğru yapılandırılmazsa, ya kimse bağlanamaz ya da istenmeyen kişiler gereksiz erişim elde edebilir. Güvenlik, burada en üst önceliklerden biri olmalı.

Bağlantı Havuzları (Connection Pooling): Neden ve Nasıl?

Her yeni veritabanı bağlantısı, sunucu tarafında belirli bir maliyeti beraberinde getirir. Kimlik doğrulama, oturum başlatma, kaynak tahsisi gibi işlemler zaman ve CPU tüketir. Yüksek trafikli uygulamalarda, her gelen web isteği için yeni bir veritabanı bağlantısı açıp kapatmak, performansı ciddi şekilde olumsuz etkileyebilir. İşte bu noktada bağlantı havuzları devreye giriyor.

Bağlantı havuzları, önceden açılmış ve kullanıma hazır veritabanı bağlantılarından oluşan bir koleksiyonu yönetir. Bir uygulama bağlantıya ihtiyaç duyduğunda, havuzdan mevcut bir bağlantıyı alır; işi bittiğinde ise bağlantıyı kapatmak yerine havuza geri verir. Böylece, bağlantı açma/kapama maliyetinden kurtulunur ve bağlantılar yeniden kullanılabilir hale gelir. Bu, özellikle kısa ömürlü, sık sık veritabanı erişimi gerektiren web uygulamaları için hayati bir optimizasyondur.

İki ana bağlantı havuzu türü vardır:

İstemci Tarafı Havuzlama: Uygulama katmanında, yani kodunuzda yönetilen havuzlardır. Çoğu ORM (Object-Relational Mapper) veya veritabanı sürücüsü kütüphanesi (örn. Java için HikariCP, Python için SQLAlchemy'nin havuz mekanizması) kendi içinde bir bağlantı havuzu sunar. Bu, uygulamanın kendi bağlantılarını yönettiği anlamına gelir.
Sunucu Tarafı Havuzlama (Proxy Havuzlama): Veritabanı sunucusu ile uygulama arasına yerleştirilen ayrı bir proxy katmanı tarafından yönetilir. PgBouncer ve Odyssey gibi araçlar bu kategoriye girer. Bu proxy'ler, birden fazla uygulamanın tek bir havuza bağlanmasını sağlayarak veritabanı sunucusunun üzerindeki bağlantı yükünü önemli ölçüde azaltır. PgBouncer'ın özellikle "transaction pooling" ve "statement pooling" modları, bağlantı sayısını daha da optimize etme yeteneği sunar. Bu tür bir havuz, birden fazla uygulama örneğinin tek bir veritabanı sunucusuna bağlandığı mikroservis mimarilerinde çok faydalıdır.

Doğru havuzlama stratejisini seçmek ve havuz boyutlarını uygulamanızın yüküne göre ayarlamak, performans ve kaynak kullanımı dengesini optimize etmek için kritik bir adımdır. Çok küçük bir havuz beklemelere yol açarken, çok büyük bir havuz gereksiz kaynak tüketimine neden olabilir.

Programatik Bağlantı Örnekleri

Farklı programlama dillerinde PostgreSQL'e bağlanmak için genellikle benzer desenler kullanılır. Bir sürücü veya kütüphane aracılığıyla bağlantı kurulur, sorgular yürütülür ve sonuçlar işlenir. İşte birkaç popüler dilde temel bağlantı örnekleri:

Python (psycopg2 ile):

CODE

12345678910111213141516171819202122232425
import psycopg2

try:
    # Bağlantı dizisi veya ayrı parametreler kullanılabilir
    conn = psycopg2.connect("dbname=veritabani user=kullanici password=parola host=localhost port=5432")
    cur = conn.cursor()

    # Bir sorgu yürütme
    cur.execute("SELECT version();")
    db_version = cur.fetchone()
    print(f"PostgreSQL versiyonu: {db_version[0]}")

    # Veri ekleme (örnek)
    # cur.execute("INSERT INTO tablo (sutun) VALUES (%s);", ("deger",))
    # conn.commit() # Değişiklikleri kaydet

    cur.close()
    conn.close()

except psycopg2.Error as e:
    print(f"Veritabanı bağlantı hatası: {e}")
    # Hata durumunda rollback yapmak iyi bir pratik olabilir
    # if 'conn' in locals() and conn:
    #     conn.rollback()

Node.js (pg kütüphanesi ile):

CODE

123456789101112131415161718192021222324
const { Client } = require('pg');

async function connectAndQuery() {
    const client = new Client({
        user: 'kullanici',
        host: 'localhost',
        database: 'veritabani',
        password: 'parola',
        port: 5432,
    });

    try {
        await client.connect();
        const res = await client.query('SELECT NOW() as now');
        console.log("Sunucu zamanı:", res.rows[0].now);
    } catch (err) {
        console.error("Veritabanı bağlantı hatası:", err);
    } finally {
        await client.end(); // Bağlantıyı kapat
    }
}

connectAndQuery();

Her iki örnekte de gördüğünüz gibi, temel adımlar aynı: bağlantı kurma, imleç/istemci oluşturma, sorgu çalıştırma ve bağlantıyı kapatma. Bağlantı havuzları kullanıldığında ise, bağlantıyı doğrudan kapatmak yerine havuza geri gönderme işlemi devreye girer.

Güvenlik Önlemleri ve En İyi Uygulamalar

PostgreSQL bağlantılarının güvenliği, en az performans kadar önemlidir. Açıkta bırakılan veya zayıf korunan bir bağlantı, tüm veritabanınızın tehlikeye girmesine yol açabilir.

SSL/TLS Kullanımı: Veritabanı ile istemci arasındaki tüm iletişimi şifrelemek için SSL/TLS kullanmak zorunludur. sslmode=require veya sslmode=verify-full gibi seçeneklerle istemcinin sunucu sertifikasını doğrulamasını sağlamak, Man-in-the-Middle (MitM) saldırılarına karşı koruma sağlar. Sunucu tarafında postgresql.conf içinde ssl = on ve uygun sertifika/anahtar dosyalarının (ssl_cert_file, ssl_key_file) yapılandırılması gerekir.
En Az Yetki Prensibi: Veritabanı kullanıcılarına yalnızca görevlerini yerine getirmek için ihtiyaç duydukları minimum yetkileri verin. Örneğin, bir web uygulaması kullanıcısının DROP TABLE veya DELETE yetkisine ihtiyacı yoksa bu yetkileri vermeyin.
Güçlü Parolalar ve Yönetimi: Karmaşık, tahmin edilemez parolalar kullanın. Parolaları asla doğrudan kod içine yazmayın. Ortam değişkenleri, güvenli yapılandırma dosyaları veya bir sır yöneticisi (secret manager) aracılığıyla yönetin.
Güvenlik Duvarı (Firewall): PostgreSQL sunucunuzun 5432 portunu (veya kullandığınız portu) yalnızca yetkili istemcilerin IP adreslerinden erişime açın. Güvenlik duvarı kuralları, ağ seviyesinde ilk savunma hattını oluşturur.
pg_hba.conf Doğru Yapılandırma: Yukarıda bahsedildiği gibi, bu dosya erişim kontrolünün temelidir. Yalnızca güvenli kimlik doğrulama yöntemlerini (örn. scram-sha-256, md5 yerine) kullanın ve trust gibi yöntemlerden kaçının.
Ağ Segmentasyonu: Veritabanı sunucularını, web sunucularından ve diğer uygulama katmanlarından ayrı, izole ağ segmentlerinde barındırmak iyi bir uygulamadır.

Bu önlemlerin her biri, veritabanı bağlantılarınızın genel güvenlik duruşunu önemli ölçüde güçlendirir.

Sık Karşılaşılan Bağlantı Sorunları ve Çözümleri

Bağlantı sorunları, geliştiricilerin ve sistem yöneticilerinin en sık karşılaştığı baş ağrılarından biridir. İşte bazı yaygın sorunlar ve olası nedenleri:

"Connection refused" veya "Could not connect to server":
Neden: PostgreSQL servisi çalışmıyor olabilir, yanlış port kullanılıyor olabilir, sunucu IP adresi yanlış olabilir veya güvenlik duvarı bağlantıyı engelliyor olabilir.
Çözüm: systemctl status postgresql (Linux için) ile servisin durumunu kontrol edin. netstat -tulnp | grep 5432 ile portun dinlenip dinlenmediğine bakın. postgresql.conf dosyasındaki listen_addresses parametresinin doğru yapılandırıldığından emin olun (örn. '*' tüm arayüzlerden dinlemek için). Güvenlik duvarı kurallarınızı kontrol edin.
"Authentication failed for user 'X'":
Neden: Yanlış kullanıcı adı veya parola, pg_hba.conf dosyasında yanlış bir kural veya yetersiz izinler.
Çözüm: Kullanıcı adını ve parolayı iki kez kontrol edin. pg_hba.conf dosyasındaki ilgili kuralı inceleyin; kimlik doğrulama yönteminin ve kullanıcı/adres eşleşmesinin doğru olduğundan emin olun. psql -U kullanici -h host -W ile manuel olarak bağlanmayı deneyerek sorunun uygulama katmanında mı yoksa veritabanı tarafında mı olduğunu anlayabilirsiniz.
"Too many connections for role 'X'":
Neden: Belirli bir kullanıcı için tanımlanmış bağlantı limiti aşılmış veya genel max_connections limiti aşılmış.
Çözüm: postgresql.conf dosyasındaki max_connections parametresini ve kullanıcıya özel ALTER ROLE ... CONNECTION LIMIT ... ayarını kontrol edin. Bağlantı havuzu kullanıyorsanız, havuz boyutlarını gözden geçirin. Gerekirse max_connections değerini artırın (ancak her artışın bellek tüketimini artıracağını unutmayın).
"FATAL: database 'X' does not exist":
Neden: Bağlanmaya çalıştığınız veritabanı adı yanlış veya mevcut değil.
Çözüm: Veritabanı adını kontrol edin, \l komutuyla (psql içinde) mevcut veritabanlarını listeleyebilirsiniz.

Bu sorun giderme adımları, çoğu bağlantı probleminde size yol gösterecektir. Önemli olan, adım adım ve sistematik bir yaklaşımla sorunun kaynağını izole etmektir.

Bağlantı Limitleri ve Yönetimi

PostgreSQL, sunucunun aynı anda kaç bağlantıyı kabul edebileceğini kontrol etmek için max_connections parametresini kullanır. Bu parametre, postgresql.conf dosyasında ayarlanır ve sunucu başlangıcında okunur. Her bir bağlantı, sunucu üzerinde belirli bir bellek ve işlemci kaynağı tükettiği için, bu değeri sunucunuzun donanım özelliklerine ve beklenen iş yüküne göre dikkatlice ayarlamak gerekir. Çok yüksek bir değer, sunucunun kaynaklarını tüketip performans düşüşüne yol açabilirken, çok düşük bir değer bağlantı reddi hatalarına neden olabilir.

Ayrıca, süper kullanıcılar için ayrılmış bağlantılar superuser_reserved_connections parametresiyle belirlenir. Bu, sunucu max_connections limitine ulaşsa bile süper kullanıcıların sorun giderme amacıyla bağlanabilmesini sağlar. Akıllıca bir güvenlik ve yönetilebilirlik önlemidir.

Veritabanı bağlantılarının derinlemesine anlaşılması ve doğru yönetimi, herhangi bir PostgreSQL tabanlı uygulamanın veya sistemin kararlılığı, performansı ve güvenliği için temel bir gerekliliktir. Gerek pg_hba.conf üzerinden erişim kontrolü, gerekse bağlantı havuzları ile kaynak optimizasyonu, hatta programatik bağlantıların güvenli bir şekilde ele alınması... Her biri titizlikle üzerinde durulması gereken konular.

Sizler bu süreçte ne gibi zorluklarla karşılaştınız? Hangi bağlantı havuzu çözümlerini tercih ediyorsunuz ve neden? Veya PostgreSQL bağlantılarını optimize etmek için kullandığınız "gizli silahlarınız" var mı? Deneyimlerinizi ve görüşlerinizi merak ediyorum... Paylaşırsanız sevinirim.

Benzer konular

İçeriği Şikayet Et