SchemaForgeスキーマ変換

五つのスキーマ形式 · どの方向へも · アップロードなし

スキーマを一つ書けば、五つの形式にブラウザで変換

データの形は一度だけ書けば十分です。SchemaForge は SQL DDL、TypeScript の型、Zod オブジェクト、Pydantic v2 モデル、JSON Schema を読み取り、一つのニュートラルなモデルにまとめ、そこから残りの四つを書き出します。入力しながらその場で切り替わります。任意項目と null 許容、既定値、VARCHAR の長さ、数値の範囲、CHECK の enum、ドキュメントコメントも潰れずに引き継がれます。アカウントも、アップロードも、サーバー呼び出しもありません。パーサーと生成器はこのタブの JavaScript です。

形式 SQL · TS · Zod · Pydantic · JSON Schema方向 20 通りの組み合わせ通信 ツールからの要求 0 件

スキーマ変換ツール

変換結果

    

    何もアップロードされません。キーを打つたびに変換し、診断一覧はニュートラルな モデルに載らなかったものを示します。

    機能

    変換ツールがすること

    六つの機能、すべてサーバーなしで。

    ANY→ANY

    五つの形式、すべての方向

    左で変換元の形式、右で変換先の形式を選びます。五つとも読み取りと書き出しの両方に 対応しているので、どの組み合わせでも動きます。SQL から Zod へ、Pydantic から TypeScript へもそのまま変換できます。

    MODEL

    中央にある本物のモデル

    各フィールドは名前、型、null 許容か、省略できるか、既定値、長さ、数値の範囲、パターン、enum の値、コメントを持つモデルになります。出力は元のテキストではなく このモデルから作られます。

    OPTIONAL

    任意と null 許容を分けて扱う

    DEFAULT のある列は省略できますが null ではありません。null 許容の列は null に なれますが必ず存在します。形式ごとに正しい書き方を使います。? と | 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 式 — は黙って消えず、警告一覧に残ります。

    使い方

    四つの手順、準備なし

    1 ページの変換ツールで、キーを打つたびに変換します。

    01

    変換元の形式を選ぶ

    SQL、TypeScript、Zod、Pydantic、JSON Schema から選びます。サンプルを読み込むと、その形式の文法がすぐ分かります。

    02

    スキーマを貼り付ける

    テーブル、インターフェース、z.object、モデルを貼り付けます。入力中に変換され、どこにも送信されません。

    03

    変換先とオプションを決める

    出力形式、キーの表記、既定値や null 許容のフィールドを任意項目にするかを選びます。

    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 のチェーンと、モデルごとの 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、null 許容のスカラーは型の配列で表します。

    形式が表現できないものは推測せずに知らせます。外部キー、特殊な CHECK 式、SQL の表に入れ子オブジェクトを書いた場合などは、結果の隣の診断一覧に表示されます。

    仕組み

    解析、モデル、生成

    変換元はどれも同じ小さなモデルにまとまり、出力はそのモデルから書かれます。

    SQL · TS · Zod · Pydantic · JSON Schema→解析→ニュートラルモデル→生成→残りの四つ
    フィールド 名前、型、必須、null 許容、既定値型 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 を走査します。

    五つとも同じモデルに着きます。モデルの一覧、そしてモデルごとのフィールドの一覧です。フィールドは名前、型ノード、そして互いに独立した三つの印 — 必須、null 許容、省略可能 — に 既定値、コメント、元が表していた制約を加えます。必須・null 許容・省略可能を分けておく ことが、SQL(NOT NULL、DEFAULT NULL)から TypeScript(name?: string | null)へ行き、戻ってきても任意かどうかが残る理由です。

    生成はその逆です。名前はキー表記のオプションで変換され、既定値は初期値になるか省かれ、enum は変換先の文法になり、コメントは変換先が持つドキュメント — TypeScript と Zod は JSDoc、Pydantic はドックストリング、SQL は -- 行、JSON Schema は description — に なります。

    質問

    よくある質問

    スキーマはサーバーに送られますか?

    いいえ。解析と生成はこのページの JavaScript です。ツールに fetch も XHR も beacon も なく、ブラウザのネットワークパネルで確認できます。外部から読み込むのはページ先頭の広告 スクリプトだけです。最後のスキーマとオプションは再読み込みしても残るよう、このブラウザの localStorage に保存されます。サイトデータを消せば一緒に消えます。

    任意と null 許容はなぜ違うのですか?

    答えている問いが違うからです。null 許容は値が null になり得るか、任意はフィールド自体が 欠け得るかを問います。DEFAULT のある SQL 列はふつう省略できますが null ではありませんし、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 のみ