JSON 轉 SQL

相關推薦

關於 JSON 轉 SQL：把 JSON 資料快速匯入關聯式資料庫

適用場景

• 把 API 回傳的 JSON 資料轉換為 INSERT 語句，匯入 MySQL/PostgreSQL 等關聯式資料庫做業務分析
• 從 JSON 設定檔或資料字典生成 CREATE TABLE 建表腳本，初始化新專案的資料庫表結構
• 把前端 mock 資料或測試資料 JSON 轉換為 SQL 腳本，用於填充測試環境的資料庫
• 資料移轉場景：把 MongoDB/Elasticsearch 匯出的 JSON 資料轉換為 SQL 腳本匯入到關聯式資料庫
• ETL 流程：將上游 JSON 資料來源預處理為標準 INSERT 語句，作為下游資料庫匯入的輸入
• 資料庫備份復原：將關鍵業務資料儲存為 JSON 格式，需要時一鍵轉換為 SQL 腳本快速復原
• 開發協作：前後端約定 JSON 資料格式，後端可一鍵轉換為建表 SQL 與種子資料 SQL
• 教學演示：演示 JSON 資料到 SQL 語句的轉換過程，幫助學習者理解型別對應和批次插入原理

使用方法

1. 在左側輸入框貼上 JSON 陣列或 JSON 物件內容，或點擊「上傳」按鈕選擇 .json/.txt 檔案，或點擊「範例」載入內建樣本
2. 在工具列右側的下拉選單中選擇目標資料庫方言（MySQL、PostgreSQL、SQLite、SQL Server 等 20 多種）
3. 點擊「設定」按鈕配置表名、是否生成 CREATE TABLE、批次插入列數（1-1000）等選項
4. 點擊「轉換」按鈕（或按快捷鍵），工具會自動解析 JSON、推斷型別、生成 SQL 並顯示在右側面板
5. 查看轉換結果：右側顯示產生的 SQL 腳本、底部狀態列顯示總列數和欄位數
6. 點擊「複製」將 SQL 複製到剪貼簿，或點擊「下載」將 SQL 儲存為 .sql 檔案（如 users.sql）
7. 將 SQL 腳本貼到資料庫用戶端（Navicat、DBeaver、pgAdmin、MySQL Workbench 等）執行即可完成資料匯入

功能特點

• INSERT 語句批次生成：自動將 JSON 陣列轉換為標準 INSERT INTO 語句，支援批次插入配置（1-1000 列/條）
• CREATE TABLE 建表腳本：可選生成 DDL 語句，自動推斷欄位型別（VARCHAR/INT/BIGINT/FLOAT/BOOLEAN/TIMESTAMP/DATE）
• 20 多種資料庫方言：覆蓋 MySQL/PostgreSQL/SQLite/SQL Server/Oracle/DB2/BigQuery/Snowflake 等主流資料庫
• 智慧型別推斷：自動識別 null/布林/整數/浮點/日期/時間/短長字串，分別對應為最合適的 SQL 型別
• SQL 自動美化：內建 sql-formatter，關鍵字大寫、縮排對齊、VALUES 多值元組結構清晰可讀
• JSON 錯誤自修復：自動修復尾隨逗號、單引號、缺引號等常見 JSON 語法錯誤，提升轉換成功率
• 欄位型別升級機制：多列資料中衝突型別自動升級（如 INT + FLOAT 升級為 FLOAT），保證型別覆蓋所有資料
• 表名與欄位名自訂：表名作為檔名下載（如 users.sql），欄位名直接採用 JSON 物件的 key
• 多種互動方式：支援貼上、檔案上傳、範例資料載入三種輸入方式，滿足不同使用習慣
• 統計資訊即時顯示：轉換後顯示總列數和欄位數，便於核對資料完整性
• 複製與下載：轉換結果可一鍵複製到剪貼簿，或下載為標準 .sql 檔案直接匯入資料庫
• 純瀏覽器本地處理：所有解析和轉換在瀏覽器 JavaScript 中完成，JSON 資料不離開裝置，保護隱私

常見問題

故障排查

術語表

JSON（JavaScript Object Notation）

輕量級資料交換格式，基於 JavaScript 物件語法，但獨立於程式語言。支援物件（{}）、陣列（[]）、字串、數字、布林、null 六種基本型別。廣泛用於 API 介面、前後端資料傳輸、設定檔、記錄檔等場景。

SQL（Structured Query Language）

結構化查詢語言，關聯式資料庫（MySQL、PostgreSQL、SQLite、SQL Server、Oracle 等）的標準操作語言。包含 DDL（資料定義，如 CREATE TABLE）、DML（資料操作，如 INSERT）、DQL（資料查詢，如 SELECT）、DCL（資料控制）等子集。

INSERT 語句

SQL 中用於向表插入資料的 DML 語句，語法為 INSERT INTO table_name (col1, col2) VALUES (val1, val2)。支援單值元組和多值元組（一條 INSERT 多列），後者可大幅提升批次匯入效能。

CREATE TABLE 語句

SQL 中用於建立表的 DDL 語句，定義表名、欄位名、資料型別、限制（NOT NULL、PRIMARY KEY、UNIQUE、DEFAULT 等）。本工具產生的 CREATE TABLE 不包含主鍵、外鍵、索引等複雜限制，保持簡潔。

SQL 方言（SQL Dialect）

不同資料庫廠商對 SQL 標準的擴充實作差異。MySQL 用反引號，PostgreSQL 用雙引號，SQL Server 用方括號；SQLite 沒有原生 BOOLEAN 用 1/0；Oracle 用 VARCHAR2；BigQuery 用 INT64 和 STRING。同一邏輯 SQL 在不同方言下語法可能不同。

DDL（Data Definition Language）

資料定義語言，SQL 子集，包含 CREATE、ALTER、DROP 等語句，用於定義和修改資料庫結構（表、檢視、索引、限制等）。本工具產生的 CREATE TABLE 屬於 DDL。

DML（Data Manipulation Language）

資料操作語言，SQL 子集，包含 INSERT、UPDATE、DELETE 語句，用於操作表中的資料列。本工具產生的 INSERT INTO 屬於 DML。

型別推斷（Type Inference）

在程式語言和工具中根據值的字面量形式自動判斷其型別的過程。本工具根據 JSON value 的 typeof（null/boolean/number/string）和具體形式（ISO 8601 日期、長度等）對應為對應的 SQL 型別。

識別符引號（Identifier Quote）

SQL 中包裹表名、欄位名等識別符的特殊字元。MySQL 用反引號 `name`，PostgreSQL 和標準 SQL 用雙引號 "name"，SQL Server 用方括號 [name]。用於保留字轉義或大小寫敏感場景。

ISO 8601 日期格式

國際標準化組織定義的日期時間表示標準，格式為 YYYY-MM-DD（日期）或 YYYY-MM-DDTHH:mm:ss（日期時間）。本工具自動識別符合該格式的字串，分別對應為 SQL 的 DATE 和 TIMESTAMP 型別。

VARCHAR 與 TEXT

SQL 中表示字串的兩種型別。VARCHAR(n) 有長度限制（n 通常最大 65535），適合短字串（姓名、Email、標題等）；TEXT 無長度限制（或限制很大），適合長文字（描述、內容、備註等）。本工具預設 255 字元以下用 VARCHAR，超過用 TEXT。

INT 與 BIGINT

SQL 中表示整數的兩種型別。INT（INTEGER）通常是 32 位元帶正負號整數，範圍 -2147483648 到 2147483647；BIGINT 是 64 位元帶正負號整數，範圍更大。本工具對絕對值超過 INT 範圍的整數自動升級為 BIGINT。

BOOLEAN 型別

SQL 中表示真值的型別。MySQL、PostgreSQL、BigQuery 等原生支援 BOOLEAN（儲存 TRUE/FALSE）；SQLite 沒有原生 BOOLEAN，用 1/0 或 INTEGER；SQL Server 用 BIT 型別；DB2 用 SMALLINT。本工具按方言自動適配。

IF NOT EXISTS 子句

CREATE TABLE 的可選項，用於在表已存在時跳過建立避免報錯。MySQL、PostgreSQL、SQLite、BigQuery 等支援；Oracle PL/SQL 和 SQL Server T-SQL 不支援（需要先判斷再建立）。本工具按方言自動決定是否輸出該子句。

批次插入（Batch Insert）

將多條資料合併為單條 INSERT 語句的技術，語法為 VALUES (1,2), (3,4), (5,6)。相比逐條插入，可減少 SQL 解析次數和網路往返，匯入效能通常提升 10-100 倍。本工具預設每條 INSERT 包含 100 列，可配置 1-1000。

sql-formatter

JavaScript SQL 格式化函式庫，支援 20 多種資料庫方言，能對 SQL 語句進行關鍵字大寫、縮排美化、關鍵字換行等處理。本工具在生成 SQL 後呼叫此函式庫做最終美化，提升可讀性。

支援的資料庫方言與關鍵差異

本工具支援的 20 多種資料庫方言及其識別符引號、資料型別、布林值表示等關鍵差異：

JSON 型別到 SQL 型別的對應規則

本工具的 detectType 函式根據 JSON value 的形式推斷 SQL 型別的完整規則：

JSON 轉 SQL 與其他格式轉換工具的對比

本工具與 JSON 轉 CSV/Excel/YAML 等其他格式轉換工具的能力差異：

Privacy & Security

本 JSON 轉 SQL 工具所有操作完全在你的瀏覽器本地完成：JSON 解析、型別推斷、SQL 生成、SQL 美化全部透過瀏覽器 JavaScript 在用戶端執行，不會透過網路向任何伺服器傳送 JSON 內容、上傳的檔案或轉換結果。檔案上傳使用瀏覽器原生 FileReader API 直接讀取到記憶體，不經過任何中介服務。不使用 Cookie 追蹤，不收集任何使用者輸入或使用資料。關閉或重新整理頁面後，所有輸入和輸出內容自動從記憶體清除。適合處理含使用者隱私、商業敏感的業務資料 JSON。

Authoritative References

• MySQLMySQL INSERT 語法官方文件
• PostgreSQLPostgreSQL INSERT 語法官方文件
• SQLiteSQLite INSERT 語法官方文件
• MicrosoftSQL Server INSERT 語法官方文件
• MDNJSON 規範 - MDN Web Docs
• WikipediaISO 8601 日期時間標準 - Wikipedia
• GitHubsql-formatter GitHub 存放庫