直接用 Dapper 执行 SQL 脚本文件(比如
.sql文件)不是它原生支持的功能,Dapper 本身只提供单条 SQL 的执行能力(
Execute、
Query等)。但你可以轻松组合 C# 基础能力 + Dapper 实现“批量执行 SQL 脚本”,关键是把脚本拆成独立语句再逐条交给 Dapper。
读取并解析 SQL 脚本文件
SQL 脚本通常包含多条语句,用分号
;分隔,可能还有注释(
--或
/* */)。Dapper 不处理这些,需自己清理和分割: 用
File.ReadAllText("script.sql") 读取整个文件内容
先移除行内注释(--后到行尾)、块注释(
/*...*/),避免误切分 按
;拆分,过滤掉空行和纯空白语句 注意:SQL Server 的
GO不是标准 SQL,Dapper 不识别,需提前替换或跳过(
GO是 SQL Server Management Studio 的批处理分隔符,不是 T-SQL 语句)
用 Dapper.Execute 批量执行每条语句
拆出有效语句后,遍历执行即可。推荐用事务包裹,确保全部成功或全部回滚:
打开连接,开启事务:using var tx = connection.BeginTransaction();对每条非空语句调用:
connection.Execute(sql, transaction: tx);全部成功后调用
tx.Commit();任一失败则
tx.Rollback()(建议用 try-catch 包裹) 注意:不能在一个 Execute 中传入含多个分号的字符串(如
"INSERT...; UPDATE...;"),Dapper 会报错 —— 它只接受单条语句
处理带参数的脚本?Dapper 不自动替换
如果脚本里写了
INSERT INTO Users VALUES (@name, @age),Dapper 不会自动绑定参数。你需要: 手动提取参数名(比如正则匹配
@\w+),构造匿名对象或
IDictionary或者更简单:脚本中避免用参数占位符,改用字符串拼接(仅限可信环境,如部署脚本) 若必须参数化,可把脚本设计成模板(如
string.Format或
SqlKata配合),再传给 Dapper
小技巧:封装成可复用方法
写个通用方法提升复用性,例如:
public static void ExecuteSqlScript(this IDbConnection conn, string scriptPath, IDbTransaction? tx = null)
{
var script = File.ReadAllText(scriptPath);
var statements = SplitSqlScript(script); // 自定义拆分逻辑
foreach (var sql in statements.Where(s => !string.IsNullOrWhiteSpace(s)))
{
conn.Execute(sql, transaction: tx);
}
}这样就能一行调用:
conn.ExecuteSqlScript("init.sql");
基本上就这些。核心就三点:读文件 → 拆语句 → 逐条 Execute。不复杂但容易忽略注释和 GO 处理,实操时注意下就行。
