EF Core ExecuteSqlRaw怎么用 EF Core执行原生增删改命令

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

EF Core 中

ExecuteSqlRaw
是执行原生 SQL 增删改(INSERT/UPDATE/DELETE)语句的常用方法,它**不返回实体数据,只返回受影响行数**,适合做批量操作、复杂更新或绕过 EF 映射限制的场景。

基本用法:执行无参数 SQL

直接传入 SQL 字符串,适用于固定语句、无用户输入的场景(如初始化数据):

context.Database.ExecuteSqlRaw("UPDATE Products SET Price = Price * 1.1 WHERE CategoryId = 5");

⚠️ 注意:这种方式**不能防止 SQL 注入**,切勿拼接用户输入!

安全写法:使用参数化查询(推荐)

{0}
占位符 + 参数数组,或命名参数(EF Core 5+ 支持):

位置参数(兼容旧版):
context.Database.ExecuteSqlRaw("DELETE FROM Orders WHERE Status = {0} AND CreatedAt 
命名参数(更清晰,推荐):
context.Database.ExecuteSqlRaw("UPDATE Users SET IsActive = {0} WHERE Email = {1}", true, "user@example.com");

EF Core 会自动处理参数转义,彻底避免 SQL 注入。

配合 FromSqlRaw 或原始查询做“先查后改”?注意误区

ExecuteSqlRaw
本身**不支持返回结果集**。如果需要“查出一批 ID 再批量更新”,别写成两步手动循环——效率低还易出错。正确做法是:

尽量用一条 SQL 完成(例如子查询或 CTE):
context.Database.ExecuteSqlRaw(@"UPDATE Orders SET Processed = 1 WHERE Id IN (SELECT Id FROM Orders WHERE Status = 'Pending' AND CreatedAt 
真需分步,用
FromSqlRaw
查 ID 列表再传入参数化 UPDATE(注意参数数量限制,SQL Server 最多 2100 个参数)。

事务与上下文状态管理

ExecuteSqlRaw
运行在当前 DbContext 的数据库连接上,但不会自动触发 EF 的变更跟踪或影响已加载实体的状态。例如:

你用
ExecuteSqlRaw
更新了数据库中某条记录,但之前已从 EF 加载到内存的对应实体对象,其属性值不会自动刷新
若后续调用
SaveChanges()
,EF 仍按它自己跟踪的旧值提交——可能覆盖你的原生更新;
解决办法:
 ✓ 手动重载实体:
context.Entry(entity).Reload();

 ✓ 或确保原生 SQL 操作前后不混用同一上下文的跟踪实体;
 ✓ 关键业务建议显式包裹事务:
using var transaction = context.Database.BeginTransaction(); ... ExecuteSqlRaw ... SaveChanges ... Commit();

基本上就这些。用对参数化、管住上下文状态、优先单条 SQL 解决问题,

ExecuteSqlRaw
就很稳。

相关推荐