导入与解析 SQL

使用对象

适合手上已有历史 SQL、想从已有结构继续演进，而不是从空白开始录入的使用者。

解决问题

你可以把外部 SQL 或结构化数据文件快速转成可编辑配置，再继续做增量设计，减少重复录入。

前置条件

你已经明确来源数据对应的数据库类型。
SQL 文本或文件可访问，且长度/大小在系统可处理范围内。

操作步骤

SQL 导入

点击顶部“导入 SQL”。结果：打开导入对话框，进入“校验”步骤。
在“源数据库”选择正确数据库类型，并粘贴 SQL。结果：系统按该方言执行解析。
点击“下一步”完成校验。结果：校验通过时进入“预览”，失败时给出错误提示与定位信息。
在“预览”中检查字段、索引、授权对象，并按需要调整字段顺序或删除不需要的字段。结果：导入内容先被你确认，再进入最终落地。
进入“确认”并执行导入。结果：解析结果写入当前工作区；若源 SQL 包含 schema，系统会把 schema 拆分到独立的 Schema Name，并把纯表名回填到 表名，后续可继续编辑并生成新 SQL。

批量 SQL 导入

在导入对话框中粘贴多条 SQL（如多个 CREATE TABLE）。结果：系统识别所有表结构。
预览时检查每张表的解析结果与冲突项。结果：若存在同名表或同名字段，系统会标注冲突并给出合并策略选项。
选择合并策略（覆盖、跳过、重命名）后执行导入。结果：多条 SQL 按策略依次落地到工作区，可大幅减少批量迁移成本。

CSV / Excel / JSON Schema 导入

点击顶部“导入数据”并选择文件类型（CSV、Excel 或 JSON Schema）。结果：打开对应文件选择器。
上传文件并确认编码与分隔符（CSV/Excel）。结果：系统解析文件内容并提取字段名与类型。
在预览中检查自动识别的字段类型，按需手动调整。结果：类型映射更符合目标数据库习惯。
确认导入。结果：字段结构写入当前工作区，可继续补充索引、授权与外键配置。

支持语句与文件边界

SQL：CREATE TABLE、CREATE INDEX、ALTER TABLE、GRANT
CSV：首行为字段名，后续行为数据；系统按数据内容推断类型
Excel：支持 .xlsx 与 .xls；自动识别首行表头
JSON Schema：支持标准 JSON Schema 格式；properties 中的字段会被解析为表字段

完成标志

导入后，表名、字段、索引、授权对象已出现在当前工作区；有 schema 时，Schema Name 也已正确回填。
右侧 DDL 与 DCL 输出不再为空，且与你预期结构一致。
你可以在导入结果基础上继续做增量调整。

易错点与失败处理

方言不匹配：同一份 SQL 在不同数据库类型下解析结果会不同。先改“源数据库”再重试。
旧 SQL 若把表名写成 schema.table，系统会优先拆成 Schema Name + 表名 两部分；导入后建议确认拆分结果是否符合预期。
SQL 过长：超出限制时会直接失败。先拆分成核心建表片段再导入。
解析失败：先保留最小可复现片段，逐段补回，快速定位问题语句。
未识别有效表结构：通常是关键建表语句缺失或语法不完整，优先检查 CREATE TABLE 主体。
CSV/Excel 类型推断偏差：自动推断基于采样数据，日期、金额等类型容易误判，导入后建议逐列确认。
JSON Schema 嵌套复杂：深层嵌套对象或数组类型可能无法直接映射为扁平表字段，建议先简化 schema 再导入。

异常排查

若 SQL 方言差异较大，优先确认数据库类型选择是否正确。
对于复杂表达式，可先最小化语句再逐段导入定位问题。
文件导入失败时，先检查文件编码是否为 UTF-8，Excel 文件是否被密码保护。