JSONからSQLへ オンライン変換ツール

代表的な使用例

ケース1：バックエンド開発者——API インターフェイスから JSON 形式のユーザーリスト（例：[{"id":1,"name":"太郎"},{"id":2,"name":"花子"}]）を取得し、MySQL の users テーブルに一括挿入する必要があります。INSERT ステートメントを手作業で記述するのは退屈でエラーが起きやすいため、このツールに JSON を貼り付けるだけで、実行可能な SQL を直接取得できます。

ケース2：データアナリスト——顧客データを分析する際、設定ファイル内のパラメータリスト（JSON 配列）をデータベースに初期化スクリプトとして書き込む必要があります。ツール使用後、生成された INSERT ステートメントを SQL クライアントにコピーするだけで完了します。

ケース3：ウェブサイト移行——古いシステムから JSON 形式のデータ（記事、カテゴリなど）をエクスポートし、ツールで INSERT ステートメントを生成して新しいデータベースに直接インポートし、煩雑なスクリプト記述を回避します。

原理とアルゴリズム

コア ロジックは非常にシンプルです。JSON オブジェクトのキー（key）を SQL テーブルの列名として、対応する値（value）を INSERT ステートメント内の値として使用します。JSON が配列の場合、各要素が 1 つの INSERT ステートメントを生成します。オブジェクトの場合は、単一のステートメントを生成します。ツールはデータ型を自動的に処理します：数値は直接書き込み、文字列は単引用符を追加して内部の単引用符をエスケープし、ブール値は 1 または 0 に変換され、null 値は SQL の NULL に変換されます。

例えば、オブジェクト {"name": "O'Brien", "age": 30} がある場合、SQL は次のようになります：INSERT INTO mytable (name, age) VALUES ('O''Brien', 30)——単引用符は正しくエスケープされます。

完全な例：JSON 配列を INSERT ステートメントに変換

ツール左側の「JSON 入力」ボックスに次のデータを貼り付けます：

[
  {"id": 1, "name": "太郎", "score": 85.5},
  {"id": 2, "name": "花子", "score": 92.0},
  {"id": 3, "name": "美咲", "score": null}
]

次に「テーブル名」入力ボックスに students と入力します。「変換」ボタンをクリックすると、右側の出力エリアに次のように表示されます：

INSERT INTO students (id, name, score) VALUES (1, '太郎', 85.5);
INSERT INTO students (id, name, score) VALUES (2, '花子', 92.0);
INSERT INTO students (id, name, score) VALUES (3, '美咲', NULL);

解説：生成された SQL は MySQL または PostgreSQL で直接実行できます（前提として、学生テーブルが既に存在することが必要です）。NULL は引用符を必要としないことに注意してください。ツールが自動的に処理しています。各ステートメントの末尾にはセミコロンがあり、コピーして貼り付けるのに便利です。

さらに詳しい例：ブール値と単引用符の処理

JSON が以下の場合：

[
  {"title": "It's a test", "published": true},
  {"title": "Say "Hello" ", "published": false}
]

テーブル名に articles と入力して変換すると、結果は以下のようになります：

INSERT INTO articles (title, published) VALUES ('It''s a test', 1);
INSERT INTO articles (title, published) VALUES ('Say "Hello" ', 0);

注意：文字列内の単引用符は 2 つの単引用符にエスケープされます（SQL 標準の実装方法）。ダブルクォートは元のまま保持されます。ブール値 true は 1 に変換され、false は 0 に変換されます。ご使用のデータベースがこのブール値表現に対応していない場合は、手動で調整してください。

結果の解釈方法

ツールが生成した SQL は通常 ANSI SQL 標準に準拠しており、MySQL、PostgreSQL、SQLite などのデータベースで直接使用できます。以下の点を確認して正確性を検証してください：

• テーブル名と列名：ターゲット データベースに対応するテーブルが存在することを確認し、列名が JSON キーと一致していること（大文字と小文字を区別）。
• データ型：数値は直接書き込み、文字列は単引用符で囲み、NULL は引用符なしです。列が整数型で小数値を指定した場合、ほとんどのデータベースは自動的に変換します。
• バッチ処理：JSON 配列に数百行ある場合、ツールは数百個の個別の INSERT ステートメントを生成します。実行効率が十分でない可能性があります。INSERT INTO ... VALUES (...), (...) 形式に手動でマージすることができます（ツールではマージをサポートしていないため、コピーして貼り付けて手動で調整する必要があります）。

よくある誤り

1. テーブル名の入力忘れ：ツールはデフォルトで table をテーブル名として使用するため、ステートメントが無効になりやすいです。毎回、テーブル名ボックスに正しい名前を入力してください。
2. JSON オブジェクトフィールドの不一致：配列内のオブジェクトに異なるキーセットが含まれている場合（例：1 番目のオブジェクトに name があるが、2 番目にない場合）、ツールはすべてのキーの和集合を取得し、不足している値は NULL で補完されます。これにより、ターゲット テーブルが NULL を許可していない場合、挿入に失敗する可能性があります。
3. ネストされたオブジェクトの未フラット化：ツールは 1 レベルの JSON オブジェクトのみ処理します。値がオブジェクトの場合（例：{"address": {"city": "東京"}}）、生成された SQL は [object Object] と直接書き込まれ、これはエラーデータです。ネストされたオブジェクトを事前にフラット構造に変換する必要があります。
4. 特殊文字への対応不足：ツールは単引用符を処理していますが、バックスラッシュや特殊な Unicode 文字は、特定のデータベース設定下では依然として問題が発生する可能性があります。小規模なサンプルで事前にテストすることをお勧めします。

制限事項と局限性

1. フラット JSON のみ対応：ネストされたオブジェクトまたは配列のネストはサポートされていません。複数レベルの構造が必要な場合は、他のツールで事前にフラット化してください。2. 入力サイズの制限：ブラウザ環境では、ツールに渡される JSON 文字列の長さはメモリ制限を受けます。1 回の処理は 10MB を超えないことをお勧めします。それ以上の場合、ページが遅くなったりクラッシュしたりする可能性があります。3. 出力構文は MySQL 寄り：基本的な構文は汎用的ですが、MySQL のブール値は 1/0 で表現され、PostgreSQL は TRUE/FALSE キーワードを使用できます。PostgreSQL を使用する場合は、1 と 0 をブール値に手動で置換する必要があります。4. DDL サポート なし：ツールは INSERT ステートメントのみを生成し、テーブルの作成はしません。事前にテーブル構造を手動で作成する必要があります。

よくある質問 FAQ

Q：ツールは単一の JSON オブジェクトを処理できますか？
できます。入力が {"a":1,"b":2} の場合、1 つの INSERT ステートメントが生成されます。

Q：JSON 内の日付はどのように処理されますか？
日付文字列は通常の文字列として扱われます（単引用符が追加されます）。ご使用のデータベースでそのカラムが日付型の場合、文字列形式はデータベース形式と一致する必要があります（例：'2023-10-01'）。

Q：REPLACE INTO または UPDATE ステートメントを生成できますか？
現在は INSERT のみを生成します。他のタイプの SQL は、手動で修正してください。

Q：生成された SQL の末尾にセミコロンがないのはなぜですか？
ツールはデフォルトで各ステートメントの末尾にセミコロンを追加します。ただし、コピー後に一括で追加または削除することができます。

Q：JSON 配列に他の型（文字列など）が混在している場合はどうなりますか？
ツールは非オブジェクト要素（数値、文字列など）をスキップし、オブジェクトのみを処理します。すべてが非オブジェクトの場合、出力は空になります。

Q：このツールはインターネット接続が必要ですか？
不要です。すべての変換はブラウザでローカルに実行され、データはサーバーにアップロードされません。安心してご使用ください。

上記の計算機に独自の JSON を貼り付けて、効果を試してみてください。