Mengonversi JSON menjadi model declarative SQLAlchemy 2.0 yang siap dijalankan: class Base(DeclarativeBase), type hint Mapped[...] dengan mapped_column(), flag nullable, __tablename__ dan primary key Integer.
Titik awal yang baik ketika backend FastAPI atau Flask harus menyimpan JSON request, atau data yang diunduh dari sistem lain, ke tabel yang belum punya model.
nullable=True terdeteksi.Nama model (default MyModel); __tablename__ adalah nama itu dalam upper snake case.models.py. Jika proyek Anda sudah punya Base, hapus yang dihasilkan dan import milik Anda, agar semua model berbagi satu 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 yang bertanda hubung tetap String(255), pages menjadi Integer, rating menjadi Float, dan published_at, tanggal tanpa waktu, menjadi Date dengan hint date. Semua nilai terisi, jadi semua kolom nullable=False.
class Base(DeclarativeBase): pass dan hanya meng-import tipe SQLAlchemy serta nama datetime yang benar-benar dipakai.Integer/int (BigInteger untuk nilai besar), desimal → Float, boolean → Boolean, YYYY-MM-DD → Date/date, tanggal-waktu → DateTime/datetime, objek dan array → JSON dengan dict/list.String(255), atau Text jika ada nilai contoh yang lebih dari 255 karakter, sehingga tabel juga bisa dibuat di MySQL.publishedAt, home-url), key aslinya diberikan sebagai nama kolom: mapped_column("publishedAt", ...). Keyword Python dan metadata diberi _ di belakang.Mapped[str | None] selain nullable=True.Integer, yang juga auto-increment di SQLite; id string di JSON Anda menjadi key String(255), dan id integer besar memakai BigInteger().with_variant(Integer, "sqlite").Jika Anda sudah punya contoh JSON request untuk schema Pydantic, buat model SQLAlchemy dari JSON yang sama dan langsung tulis alur session.add(Book(**payload)).
Setelah model terdaftar di Base.metadata, alembic revision --autogenerate menghasilkan migration create_table dari class ini.
str | None membutuhkan Python 3.10+. Di versi lebih lama, tulis Optional[str] dengan from typing import Optional.__tablename__ ditulis huruf kapital (BOOK). Akibatnya PostgreSQL membutuhkan tanda kutip di raw SQL, jadi banyak proyek mengubahnya menjadi books.db.Model alih-alih Base yang dihasilkan.Float adalah binary floating point; gunakan Numeric(10, 2) dengan Decimal untuk harga.id memakai Integer dan bukan BigInteger?SQLite hanya melakukan auto-increment pada kolom yang dideklarasikan persis sebagai INTEGER PRIMARY KEY, jadi Integer menjaga test lokal dan production berperilaku sama. Hanya ketika data Anda sudah memiliki id di atas 32 bit, key beralih ke BigInteger dengan varian SQLite.
__table_args__)?Tidak. Tabel masuk ke schema default koneksi. Untuk menargetkan schema PostgreSQL lain, tambahkan sendiri __table_args__ = {"schema": "billing"}.
Column() SQLAlchemy 1.4?Output hanya bergaya 2.0 (Mapped, mapped_column, DeclarativeBase). Untuk 1.4, gunakan declarative_base() dan tulis ulang setiap baris sebagai title = Column(String(255), nullable=False).