SQL 文件拆分与依赖合并工具

要解决的问题

大型数据库迁移时，单个 SQL 文件常混合 CREATE TABLE、CREATE VIEW、存储过程和触发器，手工拆分容易漏依赖，导入顺序一错就会出现对象缺失。sql-splitter 面向这类脚本整理场景，把多对象 SQL 文件或目录拆成独立 .sql 文件，并生成依赖排序的合并脚本。

核心能力与关键步骤

• 对象边界识别：基于 BEGIN...END 深度匹配处理过程体，兼容 IF...THEN...END IF、CASE...END CASE、LOOP...END LOOP 等嵌套；对 Oracle/达梦的 /、SQL Server 的 GO、PostgreSQL 的 $$...$$ 分别定位对象边界。
• 依赖排序：解析对象间引用，排除自引用，遇到循环依赖时按对象类型优先级追加，最终生成 merge_all.sql。
• 方言适配：支持 mysql、postgresql、oracle、sqlserver、dm、generic，合并脚本会使用对应加载方式，例如 Oracle/达梦的 @@filename、SQL Server 的 :r filename、PostgreSQL 的 \i filename。
• 对象类型：覆盖表、视图、函数、存储过程、触发器、索引、唯一索引、约束、序列、包、同义词、事件、物化视图、类型等。
• 批量与预览：可处理单文件、目录或多文件，支持 --no-merge、预览、检查点和配置管理，方便中断恢复与结果核对。

适用边界与注意点

该工具适合规范化程度较高的 SQL 脚本拆分；若对象缺少分号、视图缺少 AS、过程体缺少 BEGIN/AS，仍可能出现边界识别不准或重复文件。批量处理会按原文件名创建子目录，同名对象会追加序号。运行前建议保留备份，并用 --dialect 明确数据库类型。