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

公開ツールSQL DDL ➔ JSON Schema 変換ツール

目次
  1. 1. SQLの型はJSONスキーマの型にこうマッピングされる
  2. 2. DDL文は実際にこう解釈される
  3. 3. つまずきやすいポイント
  4. まとめ
  5. よくある質問

リレーショナルデータベース(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 文を次の順番で読めば、手作業でも同じ結果を作れます。

  1. コメントの除去: /* ... */ のブロックコメントと -- の行コメントを先に削除します。
  2. テーブル名と本文の分離: CREATE TABLE [IF NOT EXISTS] テーブル名 ( ... ) の形から、テーブル名と括弧内の内容を分けます。
  3. カラム行の分割: 括弧内の内容をカンマで区切りますが、DECIMAL(10,2) のように括弧の内側にあるカンマは無視します(括弧の開閉の深さを数えて判断します)。
  4. 行の種類の判別: 行が PRIMARY KEY、CONSTRAINT、FOREIGN KEY、UNIQUE、CHECK、INDEX で始まる場合はカラムではなくテーブル制約とみなし、このうち PRIMARY KEY(カラム1, カラム2) の形だけを required 配列に反映します。それ以外の制約はスキーマに反映されません。
  5. カラム行のパース: 残りの行は、空白で区切った最初の単語をカラム名、2番目の単語を型として読みます。続いて行全体から NOT NULL、DEFAULT 値、COMMENT '説明' をそれぞれ探し、必須項目への登録、default フィールド、description フィールドとして反映します。

私たちの無料ツールで確認する。 上記のルールをカラムの数だけ手作業で繰り返す代わりに、SQL DDLを貼り付ければ同じルールでJSONスキーマをすぐに生成します。

SQL DDL ➔ JSON Schema 変換ツール

「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 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"] のように自分で追加してください。

この記事は韓国語の原文をもとに作成しています。 韓国語の原文を読む

関連記事

  1. SQLフォーマッターの整形ルール|改行と大文字化の仕組み1行に詰まったSQLをフォーマッターが整列する際のルールを解説。キーワードだけ大文字化し、句ごとに改行、条件とサブクエリは字下げ。整形が実行結果を変えない理由もまとめました。
  2. SQLパラメータバインディングの置換ルールを確認?, :id, @name に実際の値がどう入り、どうエスケープされるかを規則で整理。数値やNULLはそのまま、文字列は引用符で囲み、コメントや文字列内の?が変わらない理由も結果で確かめられます。
  3. 文字列エスケープの変換ルール|JSON・JSでの対応表バックスラッシュ・引用符・改行・タブがJSONやJS文字列でどの記号に変わるかを表で整理。アンエスケープで戻す際の違いや、間違えやすい点も解説します。
  4. HTMLタグを除去して本文テキストだけを取り出す方法コピーしたHTMLに混ざったタグや特殊記号を取り除き、本文テキストだけを残す方法を解説します。正規表現で消す手順と、各オプションの動きを例で確認できます。
  5. 上付き・下付き文字の変換方法|x²やH₂Oをそのままコピーx²やH₂Oのような上付き・下付き文字を、フォント書式ではなく実際のUnicode文字に変換してメッセージやSNS、文書に貼り付ける方法を整理。変換の仕組み、変わらない文字、□で表示される理由まで事実をもとに説明します。
  6. SVG pathの座標抽出|d属性の数字をJSON・CSVに変換SVG pathのd属性を、M・L・C・Zの命令と座標数字に分解して読む方法を解説します。大文字と小文字の違い、C曲線の制御点まで含めて、JSON・ポイント・CSVに変換する手順も紹介します。

関連ツール