17370845950

DbFunctions 用于在 IQueryable 查询中调用数据库原生函数以实现查询下推，须通过 EF.Functions 在 Where/OrderBy/Select 中使用，不可在客户端执行或 .ToList() 后调用，不同数据库支持度不同，自定义函数需注册并确保数据库端存在。

EF Core 的 DbFunctions 用于在 LINQ 查询中调用数据库原生函数（如字符串处理、日期计算、数学运算等），让查询能下推到数据库执行，避免把大量数据拉到内存再处理。

通过 EF.Functions 访问数据库函数

EF Core 将常用数据库函数封装在 DbContext 的 EF.Functions 属性中。必须在 LINQ 查询的 Where、OrderBy、Select 等方法中使用，不能在 C# 代码中直接调用。

• 确保你的查询是 IQueryable（即未触发执行），否则会报错或回退到客户端计算
• 不同数据库支持的函数不同，例如 Like 在 SQL Server 和 SQLite 中可用，但写法和行为可能略有差异
• 使用前确认当前数据库提供程序是否支持该函数（比如 PostgreSQL 需要 Npgsql 扩展）

常用 DbFunctions 示例

以下是在 Where 或 Select 中的典型用法：

• 字符串匹配：context.Users.Where(u => EF.Functions.Like(u.Name, "%admin%"))
• 大小写不敏感比较（SQL Server）：EF.Functions.Collate(u.Name, "SQL_Lat

  

  in1_General_CP1_CI_AS")
• 日期操作：EF.Functions.DateDiffDay(u.CreatedAt, DateTime.Today) > 7
• 全文搜索（SQL Server）：EF.Functions.Contains(u.Description, "error")
• PostgreSQL 扩展函数（需引用 Npgsql.EntityFrameworkCore.PostgreSQL）：EF.Functions.ILike(u.Email, "[a-z]%@example.com")

自定义数据库函数（高级用法）

如果内置函数不够用，可通过 ModelBuilder.HasDbFunction 注册自定义标量函数（需数据库已存在该函数）：

• 先在数据库中创建函数（如 SQL Server 的 CREATE FUNCTION dbo.CalculateAge）
• 在 OnModelCreating 中注册：modelBuilder.HasDbFunction(typeof(MyDbFunctions).GetMethod(nameof(MyDbFunctions.CalculateAge)))
• 定义静态方法并标记 [DbFunction] 特性，EF 才能识别并翻译成 SQL
• 注意：自定义函数不支持客户端模拟，必须确保数据库端存在且签名一致

注意事项与避坑点

DbFunctions 很实用，但也容易出错：

• 不能在 .ToList()、.AsEnumerable() 之后使用，否则会抛 InvalidOperationException
• 部分函数（如 Random、NewId）每次查询结果可能不同，慎用于排序或分页
• SQLite 对函数支持较弱，很多 EF.Functions 方法在 SQLite 下不可用或被模拟为客户端计算
• 调试时可启用 EF 日志（LogTo(Console.WriteLine)）查看最终生成的 SQL，确认函数是否成功下推

基本上就这些。用好 DbFunctions 能写出更高效、更贴近数据库能力的查询，关键是在 IQueryable 链路里用，别让它“漏”到内存里。