SQLAlchemy 모델 클래스를 붙여넣으면 컬럼 속성 이름을 키로 하는 예시 JSON을 만듭니다. 2.0 스타일 Mapped[...]·mapped_column(), 1.x 스타일 Column(), Flask-SQLAlchemy의 db.Column()을 모두 읽고, Mixin이나 부모 클래스의 컬럼도 합칩니다.
SQLAlchemy 모델은 그대로 json.dumps할 수 없어서 FastAPI·Flask에서는 Pydantic이나 Marshmallow 스키마를 따로 둡니다. 그 스키마를 만들기 전에 모델이 어떤 필드를 가진 JSON이 될지 정리하거나, 테스트용 요청 본문을 만들 때 쓰면 됩니다.
SQLAlchemy 칸에 모델 파일을 붙여넣습니다. Base·Mixin·enum.Enum 클래스도 같은 입력에 있어야 상속 컬럼과 enum 값이 채워집니다.__tablename__이 있는 클래스만 모델로 봅니다. 모델이 여러 개면 { "User": {...}, "Team": {...} }처럼 클래스 이름별로 나옵니다.class TimestampMixin:
created_at = db.Column(db.DateTime, default=datetime.utcnow)
class Plan(enum.Enum):
FREE = "free"
PRO = "pro"
class Subscription(TimestampMixin, db.Model):
__tablename__ = "subscriptions"
id = db.Column(db.Integer, primary_key=True)
plan = db.Column(db.Enum(Plan), nullable=False)
seats = db.Column(db.SmallInteger, default=1)
trial_ends = db.Column(db.Date)
user_id = db.Column(db.Integer, db.ForeignKey("users.id"))
user = db.relationship("User", backref="subscriptions"){
"created_at": "1970-01-01T00:00:00",
"id": 0,
"plan": "free",
"seats": 1,
"trial_ends": "1970-01-01",
"user_id": 0
}TimestampMixin의 created_at이 상속 순서대로 맨 앞에 들어갔고, relationship()인 user는 컬럼이 아니라서 빠졌습니다. db.Enum(Plan)은 enum 클래스의 첫 값 "free", db.Date는 1970-01-01입니다. seats는 default=1을 따라 1이고, created_at의 datetime.utcnow는 함수라서 타입별 예시 값으로 남았습니다.
Mapped[int], Mapped[Optional[str]], Mapped[str | None] 같은 파이썬 타입 힌트에서 값을 정합니다.Column(String(50)), db.Column(db.Numeric) 등 SQL 타입 인자로 값을 정합니다.DateTime → 1970-01-01T00:00:00, Date → 1970-01-01, Time → 00:00:00, JSON·JSONB → {}, Uuid → 0으로 채운 UUID.ARRAY(String)과 Mapped[list[str]]은 원소 하나짜리 배열이 됩니다.enum.Enum을 상속한 클래스를 Enum(Plan)이나 Mapped[Plan]으로 쓰면 첫 멤버의 값을 넣습니다.relationship(), column_property(), 일반 클래스 변수, __table_args__ 같은 던더 속성은 제외합니다.FastAPI에서 response_model로 쓸 Pydantic 클래스를 만들기 전에, 모델이 내보낼 필드 목록과 타입을 JSON으로 먼저 확인합니다. 이 JSON을 JSON → Python 페이지에 넣으면 Pydantic 모델 초안도 바로 얻을 수 있습니다.
client.post("/subscriptions", json=...)에 넣을 본문을 모델 컬럼 이름과 맞춰 만들 수 있습니다. 자동 증가 id와 생성 시각은 지우고 쓰세요.
default=가 리터럴("new", 1, True, None)이면 그 값을 예시 값으로 씁니다. datetime.utcnow나 dict 같은 호출 가능한 기본값은 실행하지 않고, server_default=와 nullable=도 읽지 않습니다.Column("user_name", String)처럼 DB 컬럼 이름을 따로 줘도 JSON 키는 파이썬 속성 이름입니다.relationship)로 불러오는 연관 객체는 넣지 않으므로, 응답에 중첩 객체를 포함한다면 직접 추가하세요.hybrid_property, @property 같은 계산 속성은 포함되지 않습니다.Mapped[Optional[str]]인데 왜 null이 아니라 빈 문자열인가요?Optional은 None을 허용한다는 뜻이고, 예시는 실제로 값이 들어 있는 경우를 보여 주기 위해 안쪽 타입 str로 채웁니다. null이 오는 예시가 필요하면 결과에서 바꿔 주세요.
Z 없이 나오는 이유는요?DateTime 컬럼은 기본적으로 timezone 정보가 없는 naive datetime이고, isoformat()도 오프셋 없이 출력합니다. DateTime(timezone=True)를 쓴다면 +00:00을 붙인 예시로 바꾸는 것이 실제와 맞습니다.
아닙니다. 이 페이지는 SQLAlchemy의 Column·mapped_column·Mapped 문법만 읽습니다. Django의 models.CharField 같은 필드는 인식하지 않습니다.