插件应用市场
sql-splicer
excel数据批量转换sql
# SQL 拼接器 · Excel 转 SQL 工具
> 一款运行于 uTools 的本地插件，将 Excel 数据按自定义规则批量拼装为可直接执行的 `UPDATE` / `INSERT` SQL 语句。
---
## 一、工具概述
**SQL 拼接器**是一款面向研发与数据人员的轻量级效率工具。它通过读取本地 Excel 文件，解析表头与数据行，支持用户将每一列灵活指定为「SET 参数」「WHERE 条件」或「忽略」角色，并可把 Excel 表头映射为任意数据库字段名，最终一键生成语法正确、可直接执行的 SQL 语句。
- **核心功能**
- 读取 `.xlsx / .xls / .csv`，自动识别多工作表与表头
- 列分区：每列独立设定 `SET` / `WHERE` / `忽略` 角色
- 字段名映射：表头与数据库字段名解耦，未映射列自动跳过
- 双模式：`UPDATE`（按条件更新）与 `INSERT`（批量插入，支持多行合并）
- 数据类型处理：字符串引号转义、数字原样、日期格式化、空值 `NULL`
- 输出增强：事务包裹、批次分隔、仅预览前 N 行、复制 / 下载 `.sql`
- **目标用户**
- 后端 / 全栈开发者：需要依据业务表格批量修复或初始化数据
- 测试 / QA 工程师：构造测试数据、造数脚本
- 数据分析师 / 运维：将线下台账同步进数据库
---
## 二、使用场景
### 场景 1：批量修复线上脏数据
运维或开发收到一份 Excel 清单（如「用户 ID + 待修正的昵称 / 状态」），需要将其中成百上千行的修正值回写到数据库。
### 场景 2：从线下台账初始化数据库
业务方提供一份 Excel 台账（如商品目录、配置项），需要将其全量导入某张新建数据表，且表头命名（中文 / 业务缩写）与数据库字段名并不一致。
### 场景 3：构造测试 / 造数
测试同学需要依据一份样例 Excel 快速生成可在测试环境执行的 `INSERT` 脚本，用于铺底数据或回归验证。
---
## 三、痛点分析
### 场景 1（批量修复）的痛点
- **效率低下**：逐行手写 `UPDATE ... WHERE id = ?` 上千次，机械重复、耗时巨大。
- **易出错**：手动拼接引号、转义单引号（如 `O'Brien`）、处理空值，稍有不慎即产生语法错误或更新错行。
- **流程繁琐**：先在 Excel 里整理，再切到 SQL 客户端逐条粘贴，上下文反复切换。
### 场景 2（台账初始化）的痛点
- **字段不对应**：Excel 表头是中文或业务缩写，与数据库字段名（英文 `snake_case`）不一致，需人工逐列翻译。
- **遗漏与错位**：列多时容易漏列或错列，生成的数据错位后难以察觉。
- **NULL / 日期难处理**：空单元格、日期格式在手工拼 SQL 时极易写错（如 `'0000-00-00'`、丢失引号）。
### 场景 3（造数）的痛点
- **重复劳动**：每条测试数据都要手写 `VALUES (...)`，多行时极易少逗号、多引号。
- **不可复用**：映射规则、字段顺序全靠记忆，下次换表又得从头来。
---
## 四、解决方案
### 对应场景 1：列分区 + 自动转义
- **关键能力**：将「用户 ID」列设为 `WHERE 条件`、其余修正列设为 `SET 参数`，工具自动把每一行拼为 `UPDATE 表 SET ... WHERE ...`。
- **优势**：免去千百次手写；字符串引号自动转义（`O'Brien` → `'O''Brien'`），空值自动转为 `IS NULL` 或 `NULL`，从根源杜绝语法错误。
### 对应场景 2：字段映射 + 对照预览
- **关键能力**：在列配置表中为每列填写目标数据库字段名，表头与字段名完全解耦；未映射列在生成时自动跳过。右侧「数据预览与映射对照表」实时展示原始数据与映射关系，跳过列灰显，一目了然。
- **优势**：中文表头到英文 `snake_case` 字段的翻译集中在配置表完成，杜绝漏列 / 错列；日期类型自动规范为 `'YYYY-MM-DD HH:MM:SS'`，空值统一输出 `NULL`。
### 对应场景 3：INSERT 模式 + 多行合并
- **关键能力**：切换至 `INSERT 模式`，可配置「多行合并为单条 `VALUES (...),(...)`」，并支持事务包裹、批次分隔与仅预览前 N 行。
- **优势**：造数脚本一次生成、结构规整；映射规则随文件保存于配置，可反复复用；预览确认无误后再批量复制 / 下载 `.sql`。
---
## 五、总结
**SQL 拼接器**把「Excel 整理数据 → 手写 SQL → 反复核对」的低效链路，压缩为「载入文件 → 勾选列角色 / 填字段映射 → 一键生成」三步，凭借列分区、字段映射、类型安全转义与直观的映射对照预览，在保障 SQL 语法正确性的同时，将批量数据操作从小时级降到分钟级，是研发与数据团队处理离线数据入库 / 修复场景下的高性价比本地工具。
> 一款运行于 uTools 的本地插件，将 Excel 数据按自定义规则批量拼装为可直接执行的 `UPDATE` / `INSERT` SQL 语句。
---
## 一、工具概述
**SQL 拼接器**是一款面向研发与数据人员的轻量级效率工具。它通过读取本地 Excel 文件，解析表头与数据行，支持用户将每一列灵活指定为「SET 参数」「WHERE 条件」或「忽略」角色，并可把 Excel 表头映射为任意数据库字段名，最终一键生成语法正确、可直接执行的 SQL 语句。
- **核心功能**
- 读取 `.xlsx / .xls / .csv`，自动识别多工作表与表头
- 列分区：每列独立设定 `SET` / `WHERE` / `忽略` 角色
- 字段名映射：表头与数据库字段名解耦，未映射列自动跳过
- 双模式：`UPDATE`（按条件更新）与 `INSERT`（批量插入，支持多行合并）
- 数据类型处理：字符串引号转义、数字原样、日期格式化、空值 `NULL`
- 输出增强：事务包裹、批次分隔、仅预览前 N 行、复制 / 下载 `.sql`
- **目标用户**
- 后端 / 全栈开发者：需要依据业务表格批量修复或初始化数据
- 测试 / QA 工程师：构造测试数据、造数脚本
- 数据分析师 / 运维：将线下台账同步进数据库
---
## 二、使用场景
### 场景 1：批量修复线上脏数据
运维或开发收到一份 Excel 清单（如「用户 ID + 待修正的昵称 / 状态」），需要将其中成百上千行的修正值回写到数据库。
### 场景 2：从线下台账初始化数据库
业务方提供一份 Excel 台账（如商品目录、配置项），需要将其全量导入某张新建数据表，且表头命名（中文 / 业务缩写）与数据库字段名并不一致。
### 场景 3：构造测试 / 造数
测试同学需要依据一份样例 Excel 快速生成可在测试环境执行的 `INSERT` 脚本，用于铺底数据或回归验证。
---
## 三、痛点分析
### 场景 1（批量修复）的痛点
- **效率低下**：逐行手写 `UPDATE ... WHERE id = ?` 上千次，机械重复、耗时巨大。
- **易出错**：手动拼接引号、转义单引号（如 `O'Brien`）、处理空值，稍有不慎即产生语法错误或更新错行。
- **流程繁琐**：先在 Excel 里整理，再切到 SQL 客户端逐条粘贴，上下文反复切换。
### 场景 2（台账初始化）的痛点
- **字段不对应**：Excel 表头是中文或业务缩写，与数据库字段名（英文 `snake_case`）不一致，需人工逐列翻译。
- **遗漏与错位**：列多时容易漏列或错列，生成的数据错位后难以察觉。
- **NULL / 日期难处理**：空单元格、日期格式在手工拼 SQL 时极易写错（如 `'0000-00-00'`、丢失引号）。
### 场景 3（造数）的痛点
- **重复劳动**：每条测试数据都要手写 `VALUES (...)`，多行时极易少逗号、多引号。
- **不可复用**：映射规则、字段顺序全靠记忆，下次换表又得从头来。
---
## 四、解决方案
### 对应场景 1：列分区 + 自动转义
- **关键能力**：将「用户 ID」列设为 `WHERE 条件`、其余修正列设为 `SET 参数`，工具自动把每一行拼为 `UPDATE 表 SET ... WHERE ...`。
- **优势**：免去千百次手写；字符串引号自动转义（`O'Brien` → `'O''Brien'`），空值自动转为 `IS NULL` 或 `NULL`，从根源杜绝语法错误。
### 对应场景 2：字段映射 + 对照预览
- **关键能力**：在列配置表中为每列填写目标数据库字段名，表头与字段名完全解耦；未映射列在生成时自动跳过。右侧「数据预览与映射对照表」实时展示原始数据与映射关系，跳过列灰显，一目了然。
- **优势**：中文表头到英文 `snake_case` 字段的翻译集中在配置表完成，杜绝漏列 / 错列；日期类型自动规范为 `'YYYY-MM-DD HH:MM:SS'`，空值统一输出 `NULL`。
### 对应场景 3：INSERT 模式 + 多行合并
- **关键能力**：切换至 `INSERT 模式`，可配置「多行合并为单条 `VALUES (...),(...)`」，并支持事务包裹、批次分隔与仅预览前 N 行。
- **优势**：造数脚本一次生成、结构规整；映射规则随文件保存于配置，可反复复用；预览确认无误后再批量复制 / 下载 `.sql`。
---
## 五、总结
**SQL 拼接器**把「Excel 整理数据 → 手写 SQL → 反复核对」的低效链路，压缩为「载入文件 → 勾选列角色 / 填字段映射 → 一键生成」三步，凭借列分区、字段映射、类型安全转义与直观的映射对照预览，在保障 SQL 语法正确性的同时，将批量数据操作从小时级降到分钟级，是研发与数据团队处理离线数据入库 / 修复场景下的高性价比本地工具。