JSONをMySQLクエリに変換!

JSONを入力すると、CREATE TABLE文とINSERT文に変換します!MySQL, MariaDB 対応。
JSON
結果

JSONをMySQLクエリに変換!

JSON 配列の値を見て MySQL/MariaDB のカラム型を推論し、CREATE TABLE 文と、全行を含む INSERT 文1つを生成します。出力を MySQL クライアントに貼り付ければ、テーブルの作成とデータの投入が一度に済みます。

外部 API のデータを作業用テーブルに入れて SQL で集計したいときや、開発用データベースにテスト行を入れたいときに便利です。

使い方

  1. JSON 欄にオブジェクトの配列を貼り付けます。オブジェクト1つなら1行の INSERT になります。
  2. テーブル名 に作成するテーブルの名前を入力します(既定は my_table)。名前は URL に ?table= として残ります。
  3. 推論されたカラム型を確認し、必要に応じて長さやインデックスを調整してから、MySQL Workbench、DBeaver、mysql CLI で SQL を実行します。

例

入力 (JSON)
[
  { "id": 1, "email": "minji@example.com", "plan": "pro", "verified": true,
    "settings": { "lang": "ko" }, "joinedAt": "2024-03-01T09:30:00Z" },
  { "id": 2, "email": "tom@example.com", "plan": "free", "verified": false,
    "settings": null, "joinedAt": "2024-03-04T23:10:00Z" }
]
出力 (MySQL)
CREATE TABLE `members` (
  `id` INT NOT NULL,
  `email` VARCHAR(255) NOT NULL,
  `plan` VARCHAR(255) NOT NULL,
  `verified` TINYINT(1) NOT NULL,
  `settings` JSON NULL,
  `joinedAt` DATETIME NOT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

INSERT INTO `members` (`id`, `email`, `plan`, `verified`, `settings`, `joinedAt`) VALUES
  (1, 'minji@example.com', 'pro', 1, '{"lang":"ko"}', '2024-03-01 09:30:00'),
  (2, 'tom@example.com', 'free', 0, NULL, '2024-03-04 23:10:00');

verified は TINYINT(1) になり、オブジェクトを持つ settings は JSON カラムになりました。1行が null だったため NULL を許可しています。Z(UTC)で終わる ISO 形式の日付は MySQL が受け付ける '2024-03-01 09:30:00' の形に書き換えられ、id は全行にある整数なので主キーになっています。

対応機能

  • 型の推論: 真偽値 → TINYINT(1)、32 ビット整数 → INT、それより大きい整数 → BIGINT、小数 → DOUBLE、オブジェクトと配列 → JSON。
  • 文字列のパターン: 2024-01-02 09:00:00 や ISO 8601 → DATETIME、2024-01-02 → DATE、09:30 → TIME、それ以外 → VARCHAR(255)、ただし 255 文字を超える値が1つでもあれば TEXT。
  • 行によって型が異なる場合は広いほうの型を採用します: 整数+小数 → DOUBLE、日付+日時 → DATETIME、その他の組み合わせ → VARCHAR(255)。
  • どれかの行が null か、キーを持たない場合はそのカラムを NULL に、そうでなければ NOT NULL にします。
  • id キーがあれば PRIMARY KEY として使い、なければ id BIGINT NOT NULL AUTO_INCREMENT カラムを追加します。
  • 識別子はバッククォートで囲み、文字列内の ' と \ はエスケープします。テーブルは ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 で作成します。

利用シーン

API のデータを SQL で集計する

API から JSON として保存した決済記録やログがあるなら、テーブルに入れて GROUP BY を実行するほうが、スクリプトを書くより手早いことがよくあります。

開発・ステージング DB 用のテストデータ

モックデータ生成ツールの JSON や、キャプチャした本番のレスポンスを、マイグレーションのテストや UI 開発用の INSERT 文にできます。

注意点と制限

  • カラム名は JSON のキーそのままで、joinedAt のような camelCase は snake_case に変換されません。
  • ネストしたオブジェクトは別テーブルに正規化せず、1つの JSON カラムに入れます。
  • VARCHAR(255) の長さ、インデックス、UNIQUE 制約、DECIMAL の精度は推論しません。金額のカラムは DOUBLE から DECIMAL に変えることをおすすめします。
  • id に null が含まれている場合は、主キーなしでテーブルを作成します。
  • タイムゾーン付きの日時は UTC に変換して保存します。現地時刻の値が必要なら自分で調整してください。
  • 全行を1つの INSERT 文に入れるため、数万行になるとサーバーの max_allowed_packet の上限に達することがあります。

よくある質問

出力は PostgreSQL や SQLite でも動きますか?

そのままでは動きません。バッククォートの識別子、ENGINE=InnoDB、TINYINT(1)、AUTO_INCREMENT といった MySQL の構文を使っているためです。バッククォートをダブルクォートに、AUTO_INCREMENT を GENERATED ... AS IDENTITY などの相当する構文に置き換えてください。

BOOLEAN ではなく TINYINT(1) なのはなぜですか?

MySQL の BOOLEAN は TINYINT(1) の別名にすぎません。値は 1/0 として挿入され、型名もダンプや ORM が表示するものと一致します。

JSON カラムは古いサーバーでも使えますか?

JSON 型は MySQL 5.7.8 と MariaDB 10.2(LONGTEXT の別名)から存在します。それより古い場合は TEXT に変えてください。