数据库函数映射是将C#方法与数据库函数对应，使LINQ查询中的自定义方法能翻译为SQL函数调用。1. 使用[DbFunction]标记静态方法并配置HasDbFunction；2. 在数据库创建同名函数；3. LINQ中直接调用该方法，EF Core自动生成对应SQL，确保函数逻辑在数据库端执行，提升性能且保持代码可读性。
数据库函数映射是指将编程语言中的自定义方法或函数与数据库中的内置函数或用户定义函数进行对应，使得在使用ORM（如Entity Framework）编写LINQ查询时，能够将C#代码中的方法翻译成SQL语句中可执行的函数调用。这种机制允许开发者在保持代码可读性的同时，利用数据库的高性能函数处理数据。
为什么需要函数映射？
当你在C#中写一个LINQ查询，并希望其中某个自定义方法能在数据库端执行（而不是拉取数据到内存中再处理），就需要告诉ORM这个方法对应的是哪个数据库函数。否则，该方法无法被转换为SQL，会导致运行时异常或不正确的执行位置（比如在客户端执行而非服务器端）。
在C#中如何映射自定义函数（以Entity Framework Core为例）
EF Core 提供了 HasDbFunction 方法来注册自定义函数映射。以下是具体步骤：
1. 定义静态方法并标记为可映射
在你的DbContext派生类中，定义一个静态方法，并使用 [DbFunction] 特性标注它：
public class MyContext : DbContext
{
[DbFunction(Name = "dbo.CalculateDiscount", Schema = "dbo")]
public static decimal CalculateDiscount(decimal price, int level)
{
// 注意：此方法体不会被执行，仅用于映射
throw new NotSupportedException("This method is for database use only.");
}
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
// 显式配置函数映射（推荐）
modelBuilder.HasDbFunction(typeof(MyContext).GetMethod(nameof(CalculateDiscount)))
.HasName("CalculateDiscount")
.HasSchema("dbo");
}
}
2. 确保数据库中存在对应的函数
你需要在数据库中创建同名函数，例如在SQL Server中：
CREATE FUNCTION dbo.CalculateDiscount(@price DECIMAL(18,2), @level INT)
RETURNS DECIMAL(18,2)
AS
BEGIN
RETURN @price * (1 - (@level * 0.05)) -- 示例：每级折扣5%
END
3. 在LINQ查询中使用该函数
现在你可以在LINQ查询中调用这个方法，EF Core会将其翻译为SQL函数调用：
var products = context.Products
.Select(p => new
{
p.Name,
DiscountedPrice = MyContext.CalculateDiscount(p.Price, p.DiscountLevel)
})
.ToList();
生成的SQL会类似：
SELECT Name, dbo.CalculateDiscount(Price, DiscountLevel) AS DiscountedPrice FROM Products
映射无参数的标量函数或聚合函数
也可以映射不带参数的函数，比如获取当前租户ID或数据库时间：
[DbFunction("CURRENT_TENANT_ID", Schema = "dbo")]
public static string GetCurrentTenantId() => throw new NotSupportedException();
// 使用
var tenantId = context.GetCurrentTenantId();
基本上就这些。只要你在数据库中定义了函数，在C#中用 [DbFunction] 做好映射，并确保签名一致，EF Core就能在生成SQL时正确替换调用。注意：该功能只适用于能被翻译的表达式，不能包含复杂逻辑或外部依赖。
