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 语句的转换过程，帮助学习者理解类型映射和批量插入原理。
• Swagger/OpenAPI 文档生成的 Mock JSON 转换为目标数据库 SQL，快速搭建联调环境。
• CI/CD 数据初始化：把 YAML 流水线中的 JSON fixture 一键转为 SQL 脚本注入测试数据库做集成测试。
• 数据脱敏：把生产数据库导出的 JSON 转换为 SQL 时去掉用户敏感字段，仅做结构和类型验证用。
• 离线分析准备：分析师把第三方 JSON 数据源转换为 SQL 导入 ClickHouse/Snowflake 等 OLAP 引擎做即时查询。
• 跨方言迁移：把 MySQL dump 出来的 JSON 转换为 PostgreSQL/SQLite/Oracle 等方言的建表和插入脚本做平台迁移。

使用方法

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），适合短字符串（姓名、邮箱、标题等）；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 仓库