SQLAlchemy

ORM استاندارد پایگاه‌داده پایتون

۴.۷۷ از ۵ پایتون

این کتابخانه چیست و چه می‌کند؟

SQLAlchemy جداول را به کلاس‌های پایتون نگاشت می‌کند: به‌جای نوشتن SQL خام، با آبجکت‌ها کار می‌کنید و کوئری‌ها امن و پارامتری تولید می‌شوند. استاندارد صنعت در پروژه‌های جدی پایتون و پایه FastAPI و Flask برای کار با پایگاه‌داده است.

قابلیت‌های کلیدی

  • مدل‌های کلاس‌محور (ORM)
  • مهاجرت امن بین دیتابیس‌ها
  • کوئری پارامتری ضد SQL Injection
  • Connection pooling حرفه‌ای

مثال کاربردی واقعی

قابل اجرا
from sqlalchemy import create_engine, String
from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column

class Base(DeclarativeBase): pass

class Product(Base):
    __tablename__ = 'products'
    id: Mapped[int] = mapped_column(primary_key=True)
    title: Mapped[str] = mapped_column(String(120))
    price: Mapped[int]

engine = create_engine('sqlite:///shop.db')
Base.metadata.create_all(engine)

توضیح مثال: مدل Product تعریف و جدول در SQLite ساخته می‌شود؛ بعد از آن با Session می‌توانید Product(title=\"ماوس\", price=850000) بسازید و session.add کنید — بدون یک خط SQL.

نکات حرفه‌ای

  • برای اسکریپت‌های کوچک SQLite و برای اپ واقعی PostgreSQL بهترین جفت‌ها هستند.
  • Alembic را برای مهاجرت‌های نسخه‌بندی‌شده کنارش نصب کنید.