Dapper怎么执行SQL脚本文件 Dapper批量执行SQL语句教程

来源:这里教程网 时间:2026-02-21 17:38:09 作者:

直接用 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 处理,实操时注意下就行。

相关推荐