如何使用LINQ与Azure DocumentDB执行不区分大小写的包含查询？

嗨，我之前踩过一模一样的坑！直接在LINQ里用ToLower().Contains()确实会触发全表扫描，因为DocumentDB的索引引擎没办法识别这种转换后的表达式，只能逐条遍历文档匹配。下面给你几个亲测有效的解决方案，按推荐优先级排序：

1. 配置不区分大小写的字段索引（最优方案） #

DocumentDB支持为字段配置规范化索引，可以指定将字段值转换为小写后再建立索引。这样查询时不需要手动转大小写，系统会自动利用索引匹配，完全避免全表扫描。

操作步骤： #

• 给目标集合的索引策略添加针对/Name路径的规则，设置规范化类型为Lowercase。示例索引策略JSON：

{
  "indexingMode": "consistent",
  "automatic": true,
  "includedPaths": [
    {
      "path": "/Name/?",
      "indexes": [
        {
          "kind": "Range",
          "dataType": "String",
          "precision": -1,
          "normalization": "Lowercase"
        }
      ]
    },
    // 其他需要索引的路径...
  ],
  "excludedPaths": []
}

• 配置完成后，直接用简洁的LINQ查询即可，不需要手动转大小写：

var query = client.CreateDocumentQuery<User>(collectionUri)
                  .Where(u => u.Name.Contains(searchParam))
                  .AsDocumentQuery();

优点：不需要修改实体类或业务逻辑，索引层面解决问题，性能最优。
注意：如果集合已有数据，需要重新索引才能生效，可能需要等待一段时间。

2. 使用参数化SQL查询调用LOWER函数 #

如果暂时无法修改索引策略，可以直接写参数化SQL查询，利用LOWER函数进行大小写转换，同时确保Name字段有普通字符串索引（默认就有），这样也能避免全表扫描。

代码示例： #

var query = client.CreateDocumentQuery<User>(collectionUri, 
    new SqlQuerySpec(
        "SELECT * FROM c WHERE CONTAINS(LOWER(c.Name), @searchParamLower)",
        new SqlParameterCollection {
            new SqlParameter("@searchParamLower", searchParam.ToLower())
        }
    ))
    .AsDocumentQuery();

优点：灵活，不需要改动索引或实体类。
缺点：需要写原生SQL，不如LINQ直观，且如果Name字段没有索引，还是会全表扫描。

3. 存储字段的小写副本（兼容旧数据方案） #

如果无法修改索引策略，又想继续用LINQ语法，可以在实体类中新增一个小写版本的字段（比如NameLower），在插入或更新文档时自动赋值为Name的小写形式，之后查询直接针对这个字段操作。

代码示例： #

• 实体类：

public class User
{
    public string Id { get; set; }
    public string Name { get; set; }
    public string NameLower { get; set; } // 新增小写副本字段

    // 插入/更新时自动赋值
    public void PrepareForStorage()
    {
        NameLower = Name?.ToLowerInvariant();
    }
}

• 查询代码：

var lowerSearchParam = searchParam.ToLowerInvariant();
var query = client.CreateDocumentQuery<User>(collectionUri)
                  .Where(u => u.NameLower.Contains(lowerSearchParam))
                  .AsDocumentQuery();

优点：完全兼容LINQ语法，不需要改动索引，适合已有大量旧数据的场景。
缺点：需要维护额外字段，增加存储开销，且插入/更新时要确保同步更新小写字段。

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