SQL 建表转数据字典

要解决什么问题

数据建模或交接时，手里往往只有一份 CREATE TABLE 建表脚本，而评审、归档或给业务方对照需要的是结构化数据字典（表清单 + 字段明细）。手工从 SQL 里抄表名、字段、类型和注释，既慢又容易漏改。

技能如何工作

本技能把整份 SQL 建表脚本解析成约定格式的 Excel，默认包含两个 Sheet：

• 「目录」：数据库名、表中文名、表英文名、表说明
• 「表结构」：按表分区列出字段中文名、英文名、类型、注释、是否主键、是否非空、默认值

典型流程是：读取你提供的 SQL 文件或粘贴内容 → 确认输出路径（默认同目录 {文件名}数据字典.xlsx）→ 调用 scripts/sql_to_dict.py 完成转换 → 核对打印的表数、字段数是否与脚本一致 → 用结果预览并交付附件。若你提供了自定义模板 Excel，会按 references/template_format.md 中的版式对齐（合并单元格、边框、表间空行等）。

适用边界与注意点

• 解析逻辑主要针对 MySQL 风格的 CREATE TABLE；PostgreSQL、Oracle 等方言可能需要改脚本里的正则。
• SQL 文件默认 UTF-8 读取，编码不对时要先指定或转码。
• PRIMARY KEY 可能写在字段列表前或后，脚本会做回溯标记主键列；若 DDL 写法很非标，仍建议人工抽查几张表。