导入与解析 SQL

打开筑表师的建模工作区，再按下面的步骤导入。导入多张关联表后，可通过外键配置与 ER 图检查关系，再用ORM 模型生成导出代码。

本指南介绍如何将现有的 SQL 脚本、批量 DDL 或结构化数据文件（CSV、Excel、JSON Schema）逆向解析为可编辑的表结构模型。

适用场景

适用于存量系统重构、老项目数据库迁移、或从第三方接口定义、Excel 数据字典快速提取并生成标准表结构。

筑表师采用**「校验 → 预览 → 确认」**三步安全导入机制：

点击顶部操作栏的导入 SQL按钮。
选择源数据库方言并粘贴待解析的 SQL 脚本（支持单条或多条 CREATE TABLE、CREATE INDEX、ALTER TABLE、GRANT 语句）。
点击“下一步”进行语法解析与结构校验。
在预览面板核验与微调：
- 检查解析出的字段、类型、主键、索引及授权对象。
- 可在预览界面直接拖拽调整字段顺序或移除无关字段。
- 若解析多张表，系统会检测潜在的重名冲突，并提供覆盖、跳过、自动重命名等合并策略。
点击“确认导入”，结构将被原子写入当前工作区。若 SQL 包含命名空间（如 CREATE TABLE sales.orders），系统会自动将 sales 提取至 Schema Name，将 orders 填入 表名。

真实订单、客户名单等业务记录请使用业务数据导入。本页的 CSV / Excel 导入处理字段定义清单。

点击顶部操作栏的导入数据并选择文件类型：
- CSV 文件：首行为“字段名、字段类型、字段注释”等定义列，后续每行描述一个字段。
- Excel 表格（.xlsx / .xls）：按工作表读取字段定义清单，每行包含字段名、SQL 类型与注释。
- JSON Schema：解析 properties 字段列表及其类型、格式与描述。
上传文件后在预览界面核对字段与数据类型，按需手动纠正类型映射。
确认导入后，字段结构自动填充至当前工作区。

格式 / 来源	支持语法与对象规范	解析行为说明
SQL 脚本	`CREATE TABLE`、`CREATE INDEX`、`ALTER TABLE`、`GRANT`	精准提取列约束、默认值、注释、联合索引及权限
CSV 文件	UTF-8 编码，英文逗号分隔，首行为表头	读取字段名、显式 SQL 类型与注释
Excel 文件	支持 `.xlsx`、`.xls` 格式	读取各工作表中的字段定义清单
JSON Schema	标准 Draft-07 / 2020-12 规范	提取 `properties`，将 `string/integer/boolean` 映射为对应字段

方言不匹配排查

若导入时提示语法错误，请优先检查导入弹窗中的源数据库方言是否与 SQL 实际语法一致（例如将 Oracle 语法放入 MySQL 解析器）。