Entity Framework将Contains转为SQL LIKE/CHARINDEX的解决办法咨询

我通过OData端点从SQL数据库检索数据，C#控制器中用Entity Framework将查询转换为SQL语句。但需要针对**全文本目录（Full Text Catalogue）**使用SQL的CONTAINS函数时，Entity Framework却把OData的contains转换为LIKE或CHARINDEX，导致搜索速度极慢，完全无法利用全文本目录的优势。

相关代码与日志 #

C#控制器代码 #

[EnableQuery(AllowedQueryOptions = All)]
[ProducesResponseType(typeof(IQueryable<Events>), StatusCodes.Status200OK)]
[ProducesResponseType(StatusCodes.Status403Forbidden)]
[MapToApiVersion("1.0")]
[ODataRoute("LogEvents")]
public IQueryable<Events> GetEvents()
{
    return _dbContext.Events.AsNoTracking();
}

示例OData查询 #

http://localhost:4000/api/Events?$filter=(contains(tolower(message),'cache'))

EF生成的SQL日志片段 #

Microsoft.EntityFrameworkCore.Database.Command|YJ|17244|13|Creating DbCommand for 'ExecuteReader'
Microsoft.EntityFrameworkCore.Database.Command|YJ|17244|13|Opening connection to database 'LocalDB' on server 'sql-dev'
Microsoft.EntityFrameworkCore.Database.Command|YJ|17244|13|Opened connection to database 'LocalDB' on server 'sql-dev'
Microsoft.EntityFrameworkCore.Database.Command|YJ|17244|13|Executing DbCommand

WHERE ((@__TypedProperty_0 LIKE N'') OR (CHARINDEX(@__TypedProperty_0, LOWER([l].[Message])) > 0))

方法1：自定义OData函数映射EF的全文本CONTAINS #

1. 注册自定义OData函数
   在OData模型配置中添加自定义函数，映射到SQL的CONTAINS：

   public class ODataModelConfiguration : IModelConfiguration
   {
       public void Apply(ODataModelBuilder builder, ApiVersion apiVersion)
       {
           // 注册全文搜索自定义函数
           var fullTextFunc = builder.Function("FullTextContains")
               .Returns<bool>()
               .Parameter<string>("property")
               .Parameter<string>("searchTerm");
           
           // 绑定到EF的全文Contains方法
           fullTextFunc.Implementation = (prop, term) => EF.Functions.Contains(prop, term);
       }
   }
   

2. 使用自定义函数发起查询
   替换原生contains调用，查询URL改为：

   http://localhost:4000/api/Events?$filter=FullTextContains(message,'cache')
   

   此时EF会直接生成SQL的CONTAINS语句，利用全文本索引提速。

方法2：重写OData的contains解析逻辑（进阶） #

如果不想修改前端查询格式，可自定义OData查询绑定器，将原生contains映射为全文本CONTAINS：

1. 创建自定义FilterBinder类，重写BindContainsNode方法，将节点替换为EF.Functions.Contains的调用表达式。
2. 在OData服务配置中注册自定义的FilterBinder，覆盖默认解析逻辑。

方法3：控制器内直接处理搜索参数 #

针对特定场景，可在控制器中单独接收搜索参数，构造带全文本查询的IQueryable：

[EnableQuery(AllowedQueryOptions = AllowedQueryOptions.All & ~AllowedQueryOptions.Filter)]
[ODataRoute("LogEvents")]
public IQueryable<Events> GetEvents(ODataQueryOptions<Events> options, [FromQuery] string searchTerm)
{
    var query = _dbContext.Events.AsNoTracking();
    
    if (!string.IsNullOrEmpty(searchTerm))
    {
        // 直接使用EF全文本查询函数
        query = query.Where(e => EF.Functions.Contains(e.Message, searchTerm));
    }
    
    // 应用其他OData选项（排序、分页等）
    return options.ApplyTo(query) as IQueryable<Events>;
}

对应的查询URL改为：

http://localhost:4000/api/Events?searchTerm=cache

注意事项 #

• 确保SQL数据库中已为Message字段创建全文本索引，否则CONTAINS无法发挥性能优势。
• EF.Functions.Contains仅适配SQL Server，其他数据库需替换为对应全文本函数（如PostgreSQL的ts_match系列方法）。

内容的提问来源于stack exchange，提问作者Yash Jain