Geliştiriciler için modern web uygulamalarında veri yönetimi kritik önemdedir. FastAPI, yüksek performanslı ve kullanımı kolay bir Python web framework'üdür. PostgreSQL ise güçlü, açık kaynaklı ve ölçeklenebilir bir veritabanıdır. Bu iki teknolojiyi entegre etmek, hem hızlı geliştirme sağlar hem de güvenilir veri saklama imkanı sunar. Bu rehberde, FastAPI ile PostgreSQL bağlantısının temel adımlarını detaylandıracağım.
İlk olarak, projeyi başlatmak ve gerekli bağımlılıkları yüklemek önemli.
fastapi,
uvicorn ve
asyncpg gibi kütüphaneler başlangıç için yeterli olacaktır. Ayrıca, ORM kullanmak isterseniz
sqlalchemy ve
databases paketlerini de kurabilirsin.
1pip install fastapi uvicorn asyncpg sqlalchemy databases
Bağlantı yapılandırması için, genellikle
databases kütüphanesi kullanılır. Bu, asenkron sorgu işlemesine olanak tanır ve FastAPI ile uyum sağlar. Aşağıda temel bir bağlantı örneği yer alıyor:
12345678910111213141516171819202122
from databases import Database
from sqlalchemy import create_engine, MetaData
DATABASE_URL = "postgresql+asyncpg://kullanici:parola@localhost:5432/veritabani"
database = Database(DATABASE_URL)
engine = create_engine(DATABASE_URL)
metadata = MetaData()
[b]Uygulama başlatıldığında bağlantıyı açmak ve kapatmak için olaylar[/b]
from fastapi import FastAPI
app = FastAPI()
@app.on_event("startup")
async def startup():
await database.connect()
@app.on_event("shutdown")
async def shutdown():
await database.disconnect()
Burada,
DATABASE_URL formatı PostgreSQL bağlantısı için standarddır. Kullanıcı adı, parola, host ve veritabanı adı uygun şekilde düzenlenmeli. Ayrıca, ORM ile modeller oluşturabilir ve sorguları daha düzenli hale getirebilirsiniz.
Son olarak, CRUD işlemleri yaparken
database nesnesini kullanmak, asenkron yapıyı koruyarak yüksek performans sağlar. Örneğin, yeni kayıt ekleme veya sorgulama gibi işlemler,
await ile yapılmalı.
Bu temel yapı ile FastAPI ve PostgreSQL entegrasyonunu kurmuş olursunuz. Veritabanı tasarımı, modelleme ve sorgu optimizasyonu ise projenin ihtiyaçlarına göre şekillenecektir. Bu entegrasyon, ölçeklenebilir ve güvenilir API geliştirmede sağlam bir temel oluşturur.
