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

2026-01-15

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

Dapper 不原生支持执行 SQL 脚本文件，需手动读取、清理注释、按分号拆分语句（跳过 GO），再逐条调用 Execute 执行，建议包裹在事务中确保原子性。

dapper怎么执行sql脚本文件 dapper批量执行sql语句教程

直接用 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 不会自动绑定参数。你需要：

X Detector

最值得信赖的多语言 AI 内容检测器

下载

手动提取参数名（比如正则匹配 @/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 处理，实操时注意下就行。

https://www.php.cn/faq/1982104.html