JSON을 바로 실행할 수 있는 SQLAlchemy 2.0 선언형 모델로 바꿉니다. Base(DeclarativeBase) 클래스, mapped_column()과 함께 쓰는 Mapped[...] 타입 힌트, nullable 여부, __tablename__, Integer 기본 키가 들어갑니다.
FastAPI나 Flask 백엔드에서 받는 요청 JSON, 혹은 다른 시스템에서 내려받은 데이터를 테이블에 저장하려는데 모델을 아직 정의하지 않았을 때 출발점으로 쓰기 좋습니다.
nullable=True가 반영됩니다.모델 이름에 클래스 이름을 적습니다(기본값 MyModel). __tablename__은 이 이름을 대문자 스네이크 표기로 바꾼 값이 됩니다.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와 date 힌트가 됐습니다. 모든 값이 있어서 전부 nullable=False입니다.
class Base(DeclarativeBase): pass를 정의하고, 실제로 쓰는 SQLAlchemy 타입과 datetime 이름만 import합니다.Integer/int(큰 값은 BigInteger), 소수 → Float, 불리언 → Boolean, YYYY-MM-DD → Date/date, 날짜와 시간 → DateTime/datetime, 객체·배열 → JSON과 dict/list.String(255)이고, 샘플 값이 255자를 넘으면 Text가 됩니다. 그래서 MySQL에서도 테이블이 만들어집니다.publishedAt, home-url) mapped_column("publishedAt", ...)처럼 원래 키를 컬럼 이름으로 넘기고, Python 예약어와 metadata에는 뒤에 _를 붙입니다.nullable=True와 함께 Mapped[str | None]으로 힌트를 줍니다.Integer입니다. JSON의 id가 문자열이면 String(255) 키, 큰 정수면 BigInteger().with_variant(Integer, "sqlite")를 씁니다.Pydantic 스키마용 요청 JSON 샘플이 이미 있다면, 같은 JSON으로 SQLAlchemy 모델을 만들어 session.add(Book(**payload)) 흐름을 바로 작성할 수 있습니다.
모델을 Base.metadata에 등록하고 나면 alembic revision --autogenerate가 이 클래스로 create_table 마이그레이션을 만들어 줍니다.
str | None 힌트는 Python 3.10 이상이 필요합니다. 그보다 낮은 버전이라면 from typing import Optional과 함께 Optional[str]로 쓰세요.__tablename__이 대문자(BOOK)입니다. PostgreSQL에서는 직접 쓰는 SQL에 따옴표가 필요해지므로 books처럼 바꾸는 프로젝트가 많습니다.Base 대신 db.Model을 상속하세요.Float은 이진 부동소수점입니다. 가격에는 Decimal과 함께 Numeric(10, 2)를 쓰세요.id가 BigInteger가 아니라 Integer인 이유는요?SQLite는 정확히 INTEGER PRIMARY KEY로 선언된 컬럼만 자동 증가시키므로, Integer로 두면 로컬 테스트와 운영 환경의 동작이 같아집니다. 데이터에 이미 32비트를 넘는 id가 있을 때만 SQLite 변형을 둔 BigInteger로 바뀝니다.
__table_args__) 설정은 있나요?없습니다. 테이블은 연결의 기본 스키마에 만들어집니다. 다른 PostgreSQL 스키마를 쓰려면 __table_args__ = {"schema": "billing"}을 직접 추가하세요.
Column() 문법으로 받을 수 있나요?출력은 2.0 스타일(Mapped, mapped_column, DeclarativeBase)뿐입니다. 1.4에서는 declarative_base()를 쓰고 각 줄을 title = Column(String(255), nullable=False)처럼 바꾸세요.