JSON-কে সরাসরি চালানোর মতো SQLAlchemy 2.0 declarative মডেলে কনভার্ট করে: একটি Base(DeclarativeBase) ক্লাস, mapped_column()-সহ Mapped[...] type hint, nullable flag, __tablename__ আর একটি Integer primary key।
কোনো FastAPI বা Flask ব্যাকএন্ডকে যখন request JSON, বা অন্য সিস্টেম থেকে ডাউনলোড করা ডেটা, এমন টেবিলে রাখতে হয় যার এখনও মডেল নেই, তখন এটি ভালো শুরুর বিন্দু।
nullable=True ধরা পড়ে।মডেলের নাম-এ ক্লাসের নাম দিন (ডিফল্ট MyModel); __tablename__ হলো সেই নামের বড় হাতের snake case রূপ।models.py হিসেবে সেভ করুন। আপনার প্রজেক্টে আগে থেকেই Base থাকলে জেনারেট হওয়াটি মুছে নিজেরটি import করুন, যাতে সব মডেল একটি metadata শেয়ার করে।{
"isbn": "978-0-13-468599-1",
"title": "The Pragmatic Programmer",
"pages": 352,
"rating": 4.7,
"available": true,
"published_at": "2019-09-13"
}from datetime import date
from sqlalchemy import Boolean, Date, Float, Integer, String
from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column
class Base(DeclarativeBase):
pass
class Book(Base):
__tablename__ = "BOOK"
id: Mapped[int] = mapped_column(Integer, primary_key=True)
isbn: Mapped[str] = mapped_column(String(255), nullable=False)
title: Mapped[str] = mapped_column(String(255), nullable=False)
pages: Mapped[int] = mapped_column(Integer, nullable=False)
rating: Mapped[float] = mapped_column(Float, nullable=False)
available: Mapped[bool] = mapped_column(Boolean, nullable=False)
published_at: Mapped[date] = mapped_column(Date, nullable=False)হাইফেনযুক্ত isbn থাকে String(255), pages হয় Integer, rating হয় Float, আর সময় ছাড়া তারিখ published_at হয় date hint-সহ Date। প্রতিটি ভ্যালু আছে, তাই সব কলাম nullable=False।
class Base(DeclarativeBase): pass ডিফাইন করে এবং শুধু আসলেই ব্যবহৃত SQLAlchemy type আর datetime নামগুলো import করে।Integer/int (বড় ভ্যালুর জন্য BigInteger), দশমিক → Float, boolean → Boolean, YYYY-MM-DD → Date/date, date-time → DateTime/datetime, অবজেক্ট ও array → dict/list-সহ JSON।String(255), আর কোনো নমুনা ভ্যালু 255 অক্ষরের বেশি হলে Text, যাতে MySQL-এও টেবিল তৈরি করা যায়।publishedAt, home-url) মূল key কলামের নাম হিসেবে দেওয়া হয়: mapped_column("publishedAt", ...)। Python keyword আর metadata-এর শেষে _ যোগ হয়।nullable=True-এর পাশাপাশি Mapped[str | None] hint-ও পায়।Integer, যা SQLite-এও autoincrement হয়; আপনার JSON-এ স্ট্রিং id থাকলে String(255) key হয়, আর বড় integer id হলে BigInteger().with_variant(Integer, "sqlite") ব্যবহৃত হয়।Pydantic schema-র জন্য নমুনা request JSON আগে থেকেই থাকলে একই JSON থেকে SQLAlchemy মডেল তৈরি করে সাথে সাথেই session.add(Book(**payload)) flow লিখুন।
মডেলটি Base.metadata-তে রেজিস্টার হয়ে গেলে alembic revision --autogenerate এই ক্লাস থেকে একটি create_table migration তৈরি করে।
str | None hint-এর জন্য Python 3.10+ লাগে। পুরোনো ভার্সনে from typing import Optional-সহ Optional[str] লিখুন।__tablename__ বড় হাতের (BOOK)। ফলে PostgreSQL-এ raw SQL-এ এটি কোটে লিখতে হয়, তাই অনেক প্রজেক্ট এটিকে books-এ বদলে নেয়।Base-এর বদলে db.Model থেকে inherit করুন।Float বাইনারি floating point; দামের জন্য Decimal-সহ Numeric(10, 2) ব্যবহার করুন।id কেন BigInteger না হয়ে Integer?SQLite শুধু হুবহু INTEGER PRIMARY KEY হিসেবে ডিক্লেয়ার করা কলামকেই autoincrement করে, তাই Integer লোকাল টেস্ট আর প্রোডাকশনের আচরণ একই রাখে। আপনার ডেটায় আগে থেকেই 32 বিটের বেশি id থাকলে তবেই key SQLite variant-সহ BigInteger-এ যায়।
__table_args__) সেটিং আছে কি?না। টেবিল connection-এর ডিফল্ট schema-তে যায়। অন্য PostgreSQL schema লক্ষ্য করতে নিজে __table_args__ = {"schema": "billing"} যোগ করুন।
Column() syntax কি পাওয়া যায়?আউটপুট শুধু 2.0 স্টাইলে (Mapped, mapped_column, DeclarativeBase)। 1.4-এর জন্য declarative_base() ব্যবহার করে প্রতিটি লাইন title = Column(String(255), nullable=False) হিসেবে নতুন করে লিখুন।