Menukar JSON kepada model deklaratif SQLAlchemy 2.0 yang sedia dijalankan: kelas Base(DeclarativeBase), type hint Mapped[...] dengan mapped_column(), bendera nullable, __tablename__ dan primary key Integer.
Ia titik permulaan yang baik apabila backend FastAPI atau Flask perlu menyimpan JSON permintaan, atau data yang dimuat turun daripada sistem lain, ke dalam jadual yang belum ada model.
nullable=True dikesan.Nama model (lalai MyModel); __tablename__ ialah nama itu dalam upper snake case.models.py. Jika projek anda sudah mempunyai Base, padam yang dijana dan import milik anda, supaya semua model berkongsi 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 mengandungi sempang kekal String(255), pages menjadi Integer, rating menjadi Float, dan published_at, iaitu tarikh tanpa masa, menjadi Date dengan hint date. Setiap nilai ada, jadi semua lajur ialah nullable=False.
class Base(DeclarativeBase): pass dan hanya mengimport jenis SQLAlchemy dan nama datetime yang benar-benar digunakan.Integer/int (BigInteger untuk nilai besar), perpuluhan → Float, boolean → Boolean, YYYY-MM-DD → Date/date, tarikh-masa → DateTime/datetime, objek dan tatasusunan → JSON dengan dict/list.String(255), atau Text apabila nilai sampel melebihi 255 aksara, supaya jadual boleh dicipta pada MySQL juga.publishedAt, home-url), kunci asal dihantar sebagai nama lajur: mapped_column("publishedAt", ...). Kata kunci Python dan metadata diberi _ di hujung.Mapped[str | None] di samping nullable=True.Integer, yang auto-increment pada SQLite juga; id rentetan dalam JSON anda menjadi kunci String(255), dan id integer yang besar menggunakan BigInteger().with_variant(Integer, "sqlite").Jika anda sudah ada sampel JSON permintaan untuk skema Pydantic, jana model SQLAlchemy daripada JSON yang sama dan terus tulis aliran session.add(Book(**payload)).
Setelah model didaftarkan pada Base.metadata, alembic revision --autogenerate menghasilkan migrasi create_table daripada kelas ini.
str | None memerlukan Python 3.10+. Pada versi lebih lama, tulis Optional[str] dengan from typing import Optional.__tablename__ dalam huruf besar (BOOK). PostgreSQL kemudiannya memerlukan ia dipetik dalam SQL mentah, jadi banyak projek menukarnya kepada books.db.Model dan bukan Base yang dijana.Float ialah titik terapung binari; gunakan Numeric(10, 2) dengan Decimal untuk harga.id menggunakan Integer dan bukan BigInteger?SQLite hanya auto-increment lajur yang diisytiharkan tepat sebagai INTEGER PRIMARY KEY, jadi Integer memastikan ujian tempatan dan production berkelakuan sama. Hanya apabila data anda sudah mempunyai id melebihi 32 bit, kunci itu bertukar kepada BigInteger dengan varian SQLite.
__table_args__)?Tidak. Jadual dimasukkan ke skema lalai sambungan. Untuk menyasarkan skema PostgreSQL lain, tambah sendiri __table_args__ = {"schema": "billing"}.
Column() SQLAlchemy 1.4?Output hanya dalam gaya 2.0 (Mapped, mapped_column, DeclarativeBase). Untuk 1.4, gunakan declarative_base() dan tulis semula setiap baris sebagai title = Column(String(255), nullable=False).