JSON কে SQLAlchemy সমাধানে রূপান্তর করুন!

JSON ইনপুট করুন এবং এটিকে SQLAlchemy সমাধানে রূপান্তর করুন! SQLAlchemy 2.0 ORM, Mapped, mapped_column, Flask, FastAPI সমর্থিত।
JSON
ফলাফল
 

JSON কে SQLAlchemy সমাধানে রূপান্তর করুন!

JSON-কে সরাসরি চালানোর মতো SQLAlchemy 2.0 declarative মডেলে কনভার্ট করে: একটি Base(DeclarativeBase) ক্লাস, mapped_column()-সহ Mapped[...] type hint, nullable flag, __tablename__ আর একটি Integer primary key।

কোনো FastAPI বা Flask ব্যাকএন্ডকে যখন request JSON, বা অন্য সিস্টেম থেকে ডাউনলোড করা ডেটা, এমন টেবিলে রাখতে হয় যার এখনও মডেল নেই, তখন এটি ভালো শুরুর বিন্দু।

কীভাবে ব্যবহার করবেন

  1. একটি টেবিল row বোঝায় এমন একটি JSON অবজেক্ট পেস্ট করুন। কিছু row-এ ফাঁকা ভ্যালু থাকলে কয়েকটি row array হিসেবে পেস্ট করুন, যাতে nullable=True ধরা পড়ে।
  2. মডেলের নাম-এ ক্লাসের নাম দিন (ডিফল্ট MyModel); __tablename__ হলো সেই নামের বড় হাতের snake case রূপ।
  3. আউটপুটটি models.py হিসেবে সেভ করুন। আপনার প্রজেক্টে আগে থেকেই Base থাকলে জেনারেট হওয়াটি মুছে নিজেরটি import করুন, যাতে সব মডেল একটি metadata শেয়ার করে।

উদাহরণ

ইনপুট (JSON)
{
  "isbn": "978-0-13-468599-1",
  "title": "The Pragmatic Programmer",
  "pages": 352,
  "rating": 4.7,
  "available": true,
  "published_at": "2019-09-13"
}
আউটপুট (SQLAlchemy 2.0)
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 করে।
  • Type ম্যাপিং: integer → Integer/int (বড় ভ্যালুর জন্য BigInteger), দশমিক → Float, boolean → Boolean, YYYY-MM-DD → Date/date, date-time → DateTime/datetime, অবজেক্ট ও array → dict/list-সহ JSON।
  • স্ট্রিং হয় String(255), আর কোনো নমুনা ভ্যালু 255 অক্ষরের বেশি হলে Text, যাতে MySQL-এও টেবিল তৈরি করা যায়।
  • অ্যাট্রিবিউট snake_case। JSON key আলাদা হলে (publishedAt, home-url) মূল key কলামের নাম হিসেবে দেওয়া হয়: mapped_column("publishedAt", ...)। Python keyword আর metadata-এর শেষে _ যোগ হয়।
  • Nullable কলাম nullable=True-এর পাশাপাশি Mapped[str | None] hint-ও পায়।
  • Primary key Integer, যা SQLite-এও autoincrement হয়; আপনার JSON-এ স্ট্রিং id থাকলে String(255) key হয়, আর বড় integer id হলে BigInteger().with_variant(Integer, "sqlite") ব্যবহৃত হয়।

ব্যবহারের ক্ষেত্র

FastAPI endpoint-এর persistence মডেল

Pydantic schema-র জন্য নমুনা request JSON আগে থেকেই থাকলে একই JSON থেকে SQLAlchemy মডেল তৈরি করে সাথে সাথেই session.add(Book(**payload)) flow লিখুন।

স্বয়ংক্রিয়ভাবে তৈরি Alembic migration

মডেলটি 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-এ বদলে নেয়।
  • Flask-SQLAlchemy-তে জেনারেট হওয়া 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-এ যায়।

Schema (__table_args__) সেটিং আছে কি?

না। টেবিল connection-এর ডিফল্ট schema-তে যায়। অন্য PostgreSQL schema লক্ষ্য করতে নিজে __table_args__ = {"schema": "billing"} যোগ করুন।

SQLAlchemy 1.4-এর Column() syntax কি পাওয়া যায়?

আউটপুট শুধু 2.0 স্টাইলে (Mapped, mapped_column, DeclarativeBase)। 1.4-এর জন্য declarative_base() ব্যবহার করে প্রতিটি লাইন title = Column(String(255), nullable=False) হিসেবে নতুন করে লিখুন।