五つの形式、すべての方向
左で変換元の形式、右で変換先の形式を選びます。五つとも読み取りと書き出しの両方に 対応しているので、どの組み合わせでも動きます。SQL から Zod へ、Pydantic から TypeScript へもそのまま変換できます。
五つのスキーマ形式 · どの方向へも · アップロードなし
データの形は一度だけ書けば十分です。SchemaForge は SQL DDL、TypeScript の型、Zod オブジェクト、Pydantic v2 モデル、JSON Schema を読み取り、一つのニュートラルなモデルにまとめ、そこから残りの四つを書き出します。入力しながらその場で切り替わります。任意項目と null 許容、既定値、VARCHAR の長さ、数値の範囲、CHECK の enum、ドキュメントコメントも潰れずに引き継がれます。アカウントも、アップロードも、サーバー呼び出しもありません。パーサーと生成器はこのタブの JavaScript です。
何もアップロードされません。キーを打つたびに変換し、診断一覧はニュートラルな モデルに載らなかったものを示します。
機能
六つの機能、すべてサーバーなしで。
左で変換元の形式、右で変換先の形式を選びます。五つとも読み取りと書き出しの両方に 対応しているので、どの組み合わせでも動きます。SQL から Zod へ、Pydantic から TypeScript へもそのまま変換できます。
各フィールドは名前、型、null 許容か、省略できるか、既定値、長さ、数値の範囲、パターン、enum の値、コメントを持つモデルになります。出力は元のテキストではなく このモデルから作られます。
DEFAULT のある列は省略できますが null ではありません。null 許容の列は null に なれますが必ず存在します。形式ごとに正しい書き方を使います。? と | null、.optional() と .nullable()、Optional[...] と = None。
名前をそのまま残すか、すべてのフィールドを snake_case・camelCase・PascalCase の いずれかに一括で変えます。変換先の言語で使えない名前は使える形に直し、そのことを 知らせます。
VARCHAR(120) は .max(120)、max_length=120、maxLength: 120 になります。CHECK (status IN (...)) は Zod の enum、TypeScript のリテラルユニオン、Pydantic の Literal、JSON Schema の enum にそれぞれ移ります。
構文エラーは止まった行と桁を示します。ニュートラルなモデルに載らないもの — 外部キーや特殊な CHECK 式 — は黙って消えず、警告一覧に残ります。
使い方
1 ページの変換ツールで、キーを打つたびに変換します。
SQL、TypeScript、Zod、Pydantic、JSON Schema から選びます。サンプルを読み込むと、その形式の文法がすぐ分かります。
テーブル、インターフェース、z.object、モデルを貼り付けます。入力中に変換され、どこにも送信されません。
出力形式、キーの表記、既定値や null 許容のフィールドを任意項目にするかを選びます。
結果はコピーボタン付きのテキストで、形式に合った拡張子で保存できます。.ts、.py、.sql、.json。
対応範囲
モデルは一つ、方言は五つ。どこまで対応するかは備考に書きました。
| 形式 | 読み取るもの | 書き出すもの | 備考 |
|---|---|---|---|
SQL DDL | CREATE 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 になります。 |
TypeScript | export interface と type X = { … }、? の任意、| null、文字列リテラルのユニオン、T[] と Array<T>、インラインの入れ子オブジェクト、// と /** */ コメント | モデルごとに export interface と JSDoc コメント、基本型、配列、リテラルユニオン、入れ子のオブジェクト型 | 型は JSON ペイロードを表すので、timestamp は string、integer は number になります。 |
Zod | z.object と .optional()、.nullable()、.default()、.min()、.max()、.int()、.regex()、.email()、.describe()、z.enum、z.array、z.literal | z.object のチェーンと、モデルごとの z.infer 型エイリアス | Zod v3 のメソッド名です。厳格オプションが有効なら .strict() が付きます。 |
Pydantic v2 | class 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 Schema | Draft 2020-12 のオブジェクト: properties、required、type、enum、const、format、min/max、minLength/maxLength、pattern、items、$defs、ローカル $ref | Draft 2020-12 の文書一つ。残りのモデルは $defs に、先頭のモデルが入口 | 厳格オプションなら additionalProperties: false、null 許容のスカラーは型の配列で表します。 |
形式が表現できないものは推測せずに知らせます。外部キー、特殊な CHECK 式、SQL の表に入れ子オブジェクトを書いた場合などは、結果の隣の診断一覧に表示されます。
仕組み
変換元はどれも同じ小さなモデルにまとまり、出力はそのモデルから書かれます。
パーサーは形式ごとに一つずつ、小さく手書きした読み取り器です。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 になり得るか、任意はフィールド自体が 欠け得るかを問います。DEFAULT のある SQL 列はふつう省略できますが null ではありませんし、API のペイロードには常にありながら null になり得るキーがあります。二つを分けることで name?: string | null、z.string().nullable().optional()、Optional[str] = None のような 正しい出力になります。プロジェクトが同一視する場合は二つのオプションでまとめられます。
知らせます。FOREIGN KEY、未知の CHECK 式、対応していない型はフィールド名とともに診断一覧に 残ります。黙って捨てられるものはありません。外部キーが最も分かりやすい例です。テーブルの 関係は値の形ではないので、SchemaForge が参照型をでっち上げることはしません。
SQL には移植性のある enum がないため、CHECK (col IN ('a','b')) を enum として読み、同じ形で 書き戻します。その間では Zod の z.enum、TypeScript の文字列リテラルユニオン、Pydantic の Literal[...]、JSON Schema の enum になります。CHECK のない VARCHAR はただの文字列です。
対応範囲の表にある要素なら、はい。生成したコードから作り直したモデルが元と同じになります。それ以外は違います。ベンダー固有の型、テーブルオプション、インデックス、文章で書いた制約、Pydantic のバリデータはモデルに入らないため戻ってきません。出力は出発点として扱い、コミット前に元と比べてください。
PostgreSQL 寄りの一般的な文法です。VARCHAR(n)、NUMERIC(p,s)、BOOLEAN、TIMESTAMP、DATE、UUID、JSON 列、引用識別子、セミコロンで区切った複数の文を扱います。すべてのベンダー拡張を 読むわけではなく、他のデータベースが黙って拒否する方言固有の句も書きません。
正直な限界
CREATE TABLE を読みます。ALTER TABLE、ビュー、インデックス、シーケンス、生成列、方言固有の型は読みません。そうしたファイルは必要な CREATE TABLE 文だけにしてから 入れてください。
外部キーは参照に変えず警告で知らせます。残り四つの形式のどれもデータベースの関係を 表さないからです。複合キーは読みますが、残るのは主キーの印だけです。
timestamp は TypeScript で string、Pydantic で datetime、JSON Schema で format: date-time になります。行に入れ子になったオブジェクトは SQL で JSON 列に なります。妥当な既定ですが、プロジェクトによっては別がよいこともあります。
テーブル名は英語の複数形の規則で作り、フィールドの順序は元に従い、出力は読みやすく 整えます。名前が規約に合うか確認し、結果にプロジェクトの型チェッカーやリンターを かけてください。