SchemaForge스키마 변환기

다섯 가지 스키마 형식 · 어느 방향이든 · 업로드 없음

스키마 하나로 다섯 형식, 브라우저에서 바로 변환

데이터의 모양을 한 번만 적어 두세요. SchemaForge는 SQL DDL, TypeScript 타입, Zod 객체, Pydantic v2 모델, JSON Schema를 읽어 하나의 중립 모델로 정리하고, 그 모델에서 나머지 네 가지를 써 냅니다. 입력하는 동안 바로 바뀝니다. 선택 필드와 널 허용, 기본값, VARCHAR 길이, 숫자 범위, CHECK enum, 문서 주석이 납작해지지 않고 그대로 넘어갑니다. 계정도, 업로드도, 서버 호출도 없습니다. 파서와 생성기는 이 탭 안의 JavaScript입니다.

형식 SQL · TS · Zod · Pydantic · JSON Schema방향 스무 가지 조합네트워크 도구의 요청 0건

스키마 변환기

변환 결과

    

    아무것도 업로드되지 않습니다. 글자를 칠 때마다 변환하고, 진단 목록은 중립 모델이 담지 못한 것을 보여 줍니다.

    기능

    변환기가 하는 일

    여섯 가지, 모두 서버 없이.

    ANY→ANY

    다섯 형식, 모든 방향

    왼쪽에서 원본 형식을, 오른쪽에서 결과 형식을 고릅니다. 다섯 가지 모두 읽고 모두 써 내므로 어떤 조합이든 됩니다. SQL에서 Zod로, Pydantic에서 TypeScript로도 그대로 변환됩니다.

    MODEL

    가운데에 진짜 모델

    필드마다 이름, 타입, 널 허용 여부, 생략 가능 여부, 기본값, 길이, 숫자 범위, 패턴, enum 값, 주석이 하나의 모델로 정리됩니다. 결과는 원문이 아니라 이 모델에서 만들어집니다.

    OPTIONAL

    선택과 널 허용을 구분

    DEFAULT가 있는 컬럼은 생략할 수 있지만 널은 아닙니다. 널 허용 컬럼은 널일 수 있지만 반드시 있어야 합니다. 형식마다 맞는 표기를 씁니다: ?와 | null, .optional()과 .nullable(), Optional[...]과 = None.

    CASE

    출력할 때 키 표기 변환

    이름을 그대로 두거나, 모든 필드를 snake_case·camelCase·PascalCase 가운데 하나로 한꺼번에 바꿉니다. 대상 언어에서 쓸 수 없는 이름은 쓸 수 있게 고치고 그 사실을 알려 줍니다.

    CONSTRAINTS

    길이·범위·enum이 살아남습니다

    VARCHAR(120)은 .max(120), max_length=120, maxLength: 120이 됩니다. CHECK (status IN (...))는 Zod enum, TypeScript 리터럴 유니온, Pydantic Literal, JSON Schema enum으로 각각 옮겨집니다.

    DIAGNOSTICS

    오류는 줄과 칸으로

    문법 오류는 멈춘 줄과 칸을 알려 줍니다. 중립 모델에 담을 수 없는 것 — 외래 키, 특이한 CHECK 식 — 은 조용히 사라지지 않고 경고 목록에 남습니다.

    사용법

    네 단계, 준비 없음

    한 페이지짜리 변환기이고, 글자를 칠 때마다 다시 변환합니다.

    01

    원본 형식 고르기

    SQL, TypeScript, Zod, Pydantic, JSON Schema 가운데 하나를 고릅니다. 예제를 불러오면 그 형식의 문법을 바로 볼 수 있습니다.

    02

    스키마 붙여 넣기

    테이블, 인터페이스, z.object, 모델을 붙여 넣습니다. 입력하는 동안 변환되고, 어디에도 전송되지 않습니다.

    03

    결과 형식과 옵션 정하기

    출력 형식, 키 표기, 기본값과 널 허용 필드를 선택 필드로 바꿀지 정합니다.

    04

    복사하거나 내려받기

    결과는 복사 버튼이 있는 텍스트이고, 형식에 맞는 확장자로 내려받습니다: .ts, .py, .sql, .json.

    지원 범위

    각 형식이 읽고 쓰는 것

    모델은 하나, 방언은 다섯. 어디까지 되는지는 비고에 적었습니다.

    형식읽는 것쓰는 것비고
    SQL DDLCREATE TABLE, 컬럼 타입, NOT NULL, NULL, DEFAULT, PRIMARY KEY, UNIQUE, CHECK (col IN (...)), REFERENCES, -- 와 /* */ 주석모델마다 CREATE TABLE, VARCHAR(n)·NUMERIC·BOOLEAN·TIMESTAMP·DATE·UUID·JSON 컬럼, enum은 CHECK IN일반적인 PostgreSQL 계열 문법입니다. 테이블 이름은 모델 이름의 복수형 snake_case입니다.
    TypeScriptexport interface와 type X = { … }, ? 선택, | null, 문자열 리터럴 유니온, T[]와 Array<T>, 인라인 중첩 객체, // 와 /** */ 주석모델마다 export interface와 JSDoc 주석, 기본 타입, 배열, 리터럴 유니온, 중첩 객체 타입타입은 JSON 페이로드를 설명하므로 timestamp는 string, integer는 number가 됩니다.
    Zodz.object와 .optional(), .nullable(), .default(), .min(), .max(), .int(), .regex(), .email(), .describe(), z.enum, z.array, z.literalz.object 체인과 모델마다 export한 z.infer 타입 별칭Zod v3 메서드 이름입니다. 엄격 옵션이 켜져 있으면 .strict()가 붙습니다.
    Pydantic v2class X(BaseModel): 와 타입 표기, Optional[...], | None, Literal[...], list[...], dict[...], max_length·ge·le·pattern이 있는 Field(...)BaseModel 클래스, Field(...) 제약, Literal 유니온, 엄격 옵션이면 model_config = ConfigDict(extra="forbid")Pydantic v2 표기(ConfigDict)입니다. v1의 class Config는 만들지 않습니다.
    JSON SchemaDraft 2020-12 객체: properties, required, type, enum, const, format, min/max, minLength/maxLength, pattern, items, $defs, 로컬 $refDraft 2020-12 문서 하나. 나머지 모델은 $defs에, 첫 모델이 진입점엄격 옵션이면 additionalProperties: false, 널 허용 스칼라는 타입 배열로 씁니다.

    형식이 표현할 수 없는 것은 추측하지 않고 알려 줍니다. 외래 키, 특이한 CHECK 식, SQL 테이블에 들어간 중첩 객체는 결과 옆 진단 목록에 나타납니다.

    동작 원리

    파싱, 모델, 생성

    원본은 모두 같은 작은 모델로 정리되고, 결과는 그 모델에서 씁니다.

    SQL · TS · Zod · Pydantic · JSON Schema→파싱→중립 모델→생성→나머지 네 가지
    필드 이름, 타입, 필수, 널 허용, 기본값타입 string, int, number, bool, date-time, uuid, enum, array, object제약 maxLength, minLength, minimum, maximum, pattern출력 JSDoc, 독스트링, SQL 주석, description으로

    파서는 형식마다 하나씩 있는 작은 손수 작성한 판독기입니다. SQL 판독기는 CREATE TABLE의 문장을 따라가며 첫 옵션 키워드 앞의 타입을 집고, 이어서 NOT NULL, DEFAULT, PRIMARY KEY, UNIQUE, CHECK (col IN (...))를 순서와 상관없이 읽습니다. TypeScript 판독기는 인터페이스나 타입 별칭의 중괄호 본문을 떼어 내 최상위 세미콜론에서 필드를 나눕니다. Zod와 Pydantic 판독기는 각각 메서드 체인과 들여쓰기를 따르고, JSON Schema 판독기는 JSON을 파싱한 뒤 properties, $defs, $ref를 훑습니다.

    다섯 갈래가 모두 같은 모델에 도착합니다. 모델의 목록, 그리고 모델마다 필드의 목록입니다. 필드는 이름, 타입 노드, 그리고 서로 독립인 세 가지 표시 — 필수, 널 허용, 생략 가능 — 에 기본값, 주석, 원본이 표현한 제약을 더합니다. 필수·널 허용·생략 가능을 따로 두는 것이 SQL(NOT NULL, DEFAULT NULL)에서 TypeScript(name?: string | null)로 갔다가 되돌아와도 선택 여부가 살아 있게 하는 이유입니다.

    생성은 그 반대입니다. 이름은 키 표기 옵션으로 변환되고, 기본값은 초기값이 되거나 빠지고, enum은 대상 형식의 문법이 되고, 주석은 대상이 가진 문서 형식 — TypeScript와 Zod는 JSDoc, Pydantic은 독스트링, SQL은 -- 줄, JSON Schema는 description — 이 됩니다.

    질문

    자주 묻는 것

    스키마가 서버로 전송되나요?

    아니요. 파싱과 생성은 이 페이지의 JavaScript입니다. 도구 안에는 fetch도 XHR도 beacon도 없고, 브라우저의 네트워크 패널에서 직접 확인할 수 있습니다. 페이지 머리의 광고 스크립트만 바깥에서 불러옵니다. 마지막 스키마와 옵션은 새로 고쳐도 남도록 이 브라우저의 localStorage에 보관되며, 사이트 데이터를 지우면 함께 사라집니다.

    선택과 널 허용은 왜 다른가요?

    서로 다른 질문에 답하기 때문입니다. 널 허용은 값이 null일 수 있는지, 선택은 필드 자체가 빠질 수 있는지를 묻습니다. DEFAULT가 있는 SQL 컬럼은 보통 생략할 수 있지만 널은 아니고, API 페이로드에는 늘 있지만 null일 수 있는 키가 있습니다. 둘을 구분해야 name?: string | null, z.string().nullable().optional(), Optional[str] = None 같은 올바른 결과가 나옵니다. 두 옵션으로 프로젝트가 하나로 취급하는 경우에는 합칠 수 있습니다.

    모델에 담을 수 없는 것은 어떻게 되나요?

    알려 줍니다. FOREIGN KEY, 알 수 없는 CHECK 식, 지원하지 않는 타입은 필드 이름과 함께 진단 목록에 남습니다. 조용히 버려지는 것은 없습니다. 외래 키가 가장 분명한 예입니다. 테이블 관계는 값의 모양이 아니므로 SchemaForge가 참조 타입을 지어내지 않습니다.

    enum은 어떻게 다루나요?

    SQL에는 이식성 있는 enum이 없으므로 CHECK (col IN ('a','b'))를 enum으로 읽고 같은 방식으로 되돌려 씁니다. 그 사이에서 Zod z.enum, TypeScript 문자열 리터럴 유니온, Pydantic Literal[...], JSON Schema enum이 됩니다. CHECK가 없는 VARCHAR는 그냥 문자열입니다.

    왕복 변환이 완벽한가요?

    지원 범위 표에 적힌 요소라면 그렇습니다. 생성된 코드에서 다시 만든 모델이 원본과 같습니다. 그 밖은 아닙니다. 벤더별 타입, 테이블 옵션, 인덱스, 글로 쓴 제약, Pydantic 검증기는 모델에 들어가지 않으므로 돌아오지 않습니다. 결과는 출발점으로 보고 커밋 전에 원본과 비교하세요.

    어떤 SQL 방언을 쓰나요?

    PostgreSQL 쪽에 기운 일반 문법입니다. VARCHAR(n), NUMERIC(p,s), BOOLEAN, TIMESTAMP, DATE, UUID, JSON 컬럼과 인용 식별자, 세미콜론으로 나눈 여러 문장을 씁니다. 모든 벤더 확장을 읽지는 못하고, 다른 데이터베이스가 조용히 거부할 방언 전용 절을 쓰지도 않습니다.

    솔직한 한계

    이 도구가 하지 않는 일

    완전한 SQL 파서가 아닙니다

    CREATE TABLE을 읽습니다. ALTER TABLE, 뷰, 인덱스, 시퀀스, 생성 컬럼, 방언 전용 타입은 읽지 않으므로 그런 파일은 필요한 CREATE TABLE 문만 남겨서 넣으세요.

    관계는 모델링하지 않습니다

    외래 키는 참조로 바꾸지 않고 경고로 알립니다. 나머지 네 형식 중 어느 것도 데이터베이스 관계를 설명하지 않기 때문입니다. 복합 키는 읽지만 남는 것은 기본 키 표시뿐입니다.

    타입 대응은 관례입니다

    timestamp는 TypeScript에서 string, Pydantic에서 datetime, JSON Schema에서 format: date-time이 됩니다. 행 안에 중첩된 객체는 SQL에서 JSON 컬럼이 됩니다. 합리적인 기본값이지만 프로젝트에 따라 다를 수 있습니다.

    생성 코드는 검토가 필요합니다

    테이블 이름은 영어 복수형 규칙으로 만들고, 필드 순서는 원본을 따르며, 출력은 읽기 좋게 정리됩니다. 이름을 규칙에 맞게 확인한 뒤 결과에 프로젝트의 타입 검사기나 린터를 돌리세요.

    출력이 따르는 표준

    • JSON Schema — Draft 2020-12, $defs와 $ref
    • Pydantic — version 2 (ConfigDict, Field, Literal)
    • Zod — version 3 (z.object, z.enum, z.infer)
    • 개인정보 — 업로드·계정·분석 없음, 작업 내용은 localStorage에만