Konversi JSON ke Skema SQLAlchemy!

Masukkan JSON dan konversikan ke skema SQLAlchemy! Mendukung SQLAlchemy 2.0 ORM, Mapped, mapped_column, Flask, FastAPI.
JSON
Hasil
 

Konversi JSON ke Skema SQLAlchemy!

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.

Cara menggunakan

  1. Tempel objek JSON yang mewakili satu baris tabel. Jika ada baris yang nilainya kosong, tempel beberapa baris sebagai array agar nullable=True terdeteksi.
  2. Isi nama class di Nama model (default MyModel); __tablename__ adalah nama itu dalam upper snake case.
  3. Simpan output sebagai models.py. Jika proyek Anda sudah punya Base, hapus yang dihasilkan dan import milik Anda, agar semua model berbagi satu metadata.

Contoh

Input (JSON)
{
  "isbn": "978-0-13-468599-1",
  "title": "The Pragmatic Programmer",
  "pages": 352,
  "rating": 4.7,
  "available": true,
  "published_at": "2019-09-13"
}
Output (SQLAlchemy 2.0)
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.

Fitur yang didukung

  • Mendefinisikan class Base(DeclarativeBase): pass dan hanya meng-import tipe SQLAlchemy serta nama datetime yang benar-benar dipakai.
  • Pemetaan tipe: integer → 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 menjadi String(255), atau Text jika ada nilai contoh yang lebih dari 255 karakter, sehingga tabel juga bisa dibuat di MySQL.
  • Atribut ditulis snake_case. Jika key JSON berbeda (publishedAt, home-url), key aslinya diberikan sebagai nama kolom: mapped_column("publishedAt", ...). Keyword Python dan metadata diberi _ di belakang.
  • Kolom nullable diberi hint Mapped[str | None] selain nullable=True.
  • Primary key berupa 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").

Kasus penggunaan

Model persistensi untuk endpoint FastAPI

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)).

Migration Alembic yang dibuat otomatis

Setelah model terdaftar di Base.metadata, alembic revision --autogenerate menghasilkan migration create_table dari class ini.

Catatan dan batasan

  • Hint 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.
  • Dengan Flask-SQLAlchemy, warisi db.Model alih-alih Base yang dihasilkan.
  • Float adalah binary floating point; gunakan Numeric(10, 2) dengan Decimal untuk harga.

FAQ

Mengapa 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.

Apakah ada pengaturan schema (__table_args__)?

Tidak. Tabel masuk ke schema default koneksi. Untuk menargetkan schema PostgreSQL lain, tambahkan sendiri __table_args__ = {"schema": "billing"}.

Bisakah saya mendapatkan sintaks 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).