SQLAlchemy 모델을 JSON으로 변환하세요!

SQLAlchemy ORM 모델을 입력하면 예시 JSON을 만듭니다! API 테스트용 요청 본문(sample JSON)에.
SQLAlchemy
결과
 

SQLAlchemy 모델을 JSON으로 변환하세요!

SQLAlchemy 모델 클래스를 붙여넣으면 컬럼 속성 이름을 키로 하는 예시 JSON을 만듭니다. 2.0 스타일 Mapped[...]·mapped_column(), 1.x 스타일 Column(), Flask-SQLAlchemy의 db.Column()을 모두 읽고, Mixin이나 부모 클래스의 컬럼도 합칩니다.

SQLAlchemy 모델은 그대로 json.dumps할 수 없어서 FastAPI·Flask에서는 Pydantic이나 Marshmallow 스키마를 따로 둡니다. 그 스키마를 만들기 전에 모델이 어떤 필드를 가진 JSON이 될지 정리하거나, 테스트용 요청 본문을 만들 때 쓰면 됩니다.

사용 방법

  1. SQLAlchemy 칸에 모델 파일을 붙여넣습니다. Base·Mixin·enum.Enum 클래스도 같은 입력에 있어야 상속 컬럼과 enum 값이 채워집니다.
  2. __tablename__이 있는 클래스만 모델로 봅니다. 모델이 여러 개면 { "User": {...}, "Team": {...} }처럼 클래스 이름별로 나옵니다.
  3. 결과를 복사합니다.

예시

입력 (Python · Flask-SQLAlchemy)
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")
출력 (JSON)
{
  "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__ 같은 던더 속성은 제외합니다.
  • Mixin과 부모 모델의 컬럼은 자식 컬럼보다 먼저 들어갑니다.

사용 사례

Pydantic 응답 모델 초안

FastAPI에서 response_model로 쓸 Pydantic 클래스를 만들기 전에, 모델이 내보낼 필드 목록과 타입을 JSON으로 먼저 확인합니다. 이 JSON을 JSON → Python 페이지에 넣으면 Pydantic 모델 초안도 바로 얻을 수 있습니다.

Flask API 테스트 데이터

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이 오는 예시가 필요하면 결과에서 바꿔 주세요.

datetime이 Z 없이 나오는 이유는요?

DateTime 컬럼은 기본적으로 timezone 정보가 없는 naive datetime이고, isoformat()도 오프셋 없이 출력합니다. DateTime(timezone=True)를 쓴다면 +00:00을 붙인 예시로 바꾸는 것이 실제와 맞습니다.

Django 모델도 변환되나요?

아닙니다. 이 페이지는 SQLAlchemy의 Column·mapped_column·Mapped 문법만 읽습니다. Django의 models.CharField 같은 필드는 인식하지 않습니다.