SQL DDLからJSON Schemaへの型マッピング規則

リレーショナルデータベース(RDB)の CREATE TABLE 文と、APIやドキュメント指向データベースで広く使われるJSONスキーマ(JSON Schema Draft-07)は表現方法が異なるため、カラムを1つずつ人の目で照合しながら移し替えていると、型や必須値の扱いを見落としがちです。どのSQL型がどのJSON型になるのか、NOT NULL と UNIQUE がそれぞれどう扱われるのかをルールとして整理しておけば、こうしたミスを減らせます。
まとめ ① SQLの型は、整数・実数・真偽値・日付・JSONなどいくつかの系統に分かれ、それぞれJSONスキーマの型にマッピングされます。 ②
required配列に自動で入るのはNOT NULLとPRIMARY KEYのカラムだけで、UNIQUEは入りません。 ③VARCHARの長さ(maxLength)とENUMのリストは自動変換されないため、自分で追加する必要があります。
1. SQLの型はJSONスキーマの型にこうマッピングされる
SQL DDLで使われるデータ型は、次の基準でJSONスキーマ Draft-07 の type プロパティに変わります。
- 整数:
INT、INTEGER、TINYINT、SMALLINT、MEDIUMINT、BIGINT、SERIAL、BIGSERIAL→{ "type": "integer" } - 実数:
DECIMAL、NUMERIC、FLOAT、DOUBLE、REAL→{ "type": "number" } - 真偽値:
BOOLEAN、BOOL→{ "type": "boolean" } - 日付:
DATE→{ "type": "string", "format": "date" }/TIMESTAMP、DATETIME→{ "type": "string", "format": "date-time" } - JSON系:
JSON、JSONB→{ "type": "object" } - その他の文字列系:
VARCHAR、CHAR、TEXTなどはすべて{ "type": "string" }として処理されます。VARCHAR(50)のように長さが付いていても、maxLengthは自動では追加されません。
必須かどうかは型とは別に処理されます。NOT NULL が付いたカラムと PRIMARY KEY に指定されたカラムだけが、最上位の required 配列に自動で登録されます。UNIQUE 制約は値の重複を防ぐだけで値の存在を強制するものではないため、required 配列には自動で入りません。「必須でないカラムの型をnullとのユニオン型にする」オプションをオンにすると、required に含まれないカラムの型が ["string", "null"] のようにnullとのユニオン型に変わります。
2. DDL文は実際にこう解釈される
SQLの CREATE TABLE 文を次の順番で読めば、手作業でも同じ結果を作れます。
- コメントの除去:
/* ... */のブロックコメントと--の行コメントを先に削除します。 - テーブル名と本文の分離:
CREATE TABLE [IF NOT EXISTS] テーブル名 ( ... )の形から、テーブル名と括弧内の内容を分けます。 - カラム行の分割: 括弧内の内容をカンマで区切りますが、
DECIMAL(10,2)のように括弧の内側にあるカンマは無視します(括弧の開閉の深さを数えて判断します)。 - 行の種類の判別: 行が
PRIMARY KEY、CONSTRAINT、FOREIGN KEY、UNIQUE、CHECK、INDEXで始まる場合はカラムではなくテーブル制約とみなし、このうちPRIMARY KEY(カラム1, カラム2)の形だけをrequired配列に反映します。それ以外の制約はスキーマに反映されません。 - カラム行のパース: 残りの行は、空白で区切った最初の単語をカラム名、2番目の単語を型として読みます。続いて行全体から
NOT NULL、DEFAULT 値、COMMENT '説明'をそれぞれ探し、必須項目への登録、defaultフィールド、descriptionフィールドとして反映します。
私たちの無料ツールで確認する。 上記のルールをカラムの数だけ手作業で繰り返す代わりに、SQL DDLを貼り付ければ同じルールでJSONスキーマをすぐに生成します。
「SQL DDL ➔ JSON Schema 変換ツール」に変換したいリレーショナルデータベースのSQL CREATE TABLE DDL文を入力すると、最新の標準JSON Schema検証オブジェクトのソースコードを簡単に自動生成できます。

3. つまずきやすいポイント
| 状況 | 実際の動作 |
|---|---|
VARCHAR(50) のように長さを指定 | 型は string に変換されますが、maxLength は自動では付きません。 |
UNIQUE 制約 | PRIMARY KEY と違い、required 配列に自動では入りません。 |
ENUM('a','b') | リストを読み取って enum 配列を作ることはせず、string 型に変換されるだけです。 |
COMMENT '説明' | description フィールドとして自動で反映されます。 |
DEFAULT 値 | NULL や CURRENT_TIMESTAMP の類を除き、default フィールドとして反映されます。 |
まとめ
- 整数・実数・真偽値・JSON系は、型名だけでそのままマッピングされます。
- 日付系は
DATEとTIMESTAMP/DATETIMEで異なるformat値になります。 required配列はNOT NULLとPRIMARY KEYのカラムだけを自動で埋め、UNIQUEは含めません。VARCHARの長さ(maxLength)とENUMのリストは自動変換の対象ではないため、必要なら変換結果を受け取ったあとに自分で追加します。
「SQL DDL ➔ JSON Schema 変換ツール」に変換したいリレーショナルデータベースのSQL CREATE TABLE DDL文を入力すると、最新の標準JSON Schema検証オブジェクトのソースコードを簡単に自動生成できます。
よくある質問
VARCHARの長さはJSONスキーマのmaxLengthに自動変換されますか?
いいえ。現在の変換ツールは型のみをマッピングし、長さの制約は入れません。必要であれば、変換後のJSONで該当するフィールドに "maxLength": 50 のように自分で追加してください。
UNIQUE制約があるカラムもrequired配列に自動で入りますか?
いいえ。required 配列に入るのは NOT NULL のカラムと PRIMARY KEY のカラムだけです。UNIQUE は重複を防ぐ制約であって値の存在を強制する制約ではないため、別途処理されることはありません。必須にしたい場合は、変換後に required 配列へ自分で追加する必要があります。
ENUM型はどう処理されますか?
現在のバージョンでは ENUM のリストを自動で読み取って enum 配列を作ることはせず、文字列(string)型に変換するだけです。選べる値を限定したい場合は、変換後のJSONに "enum": ["active", "inactive"] のように自分で追加してください。
この記事は韓国語の原文をもとに作成しています。 韓国語の原文を読む