如何通过Java Cosmos SDK的Criteria实现SUBSTRING查询功能？

问题场景 #

我的Cosmos DB里有这样的文档：

{
   "startDate": "2023-11-17T08:11:30.225323"
}

用完整时间的SQL查询能正常返回结果：

select *
from c
where c.startDate = "2023-11-17T08:11:30.225323"

但我需要按纯日期部分（比如2023-11-17）查询，直接用SUBSTRING(c.startDate,0,10) = "2023-11-17"的SQL语句能得到预期结果。

现在我用Azure Spring Data Cosmos的com.azure.spring.data.cosmos.core.query.Criteria类构建查询，完整时间匹配的代码是这样的：

Criteria c1 = Criteria.getInstance(CriteriaType.IS_EQUAL, "startDate", Collections.singletonList(startDate), Part.IgnoreCaseType.NEVER);

想知道怎么用这个Criteria类实现SUBSTRING的查询逻辑？

实现方案 #

Azure Spring Data Cosmos的Criteria没有内置SUBSTRING的匹配类型，但可以通过CriteriaType.CUSTOM自定义SQL表达式来实现，具体代码如下：

String targetDate = "2023-11-17";
// 自定义条件，用SUBSTRING截取startDate的前10位并匹配目标日期
Criteria dateCriteria = Criteria.getInstance(
    CriteriaType.CUSTOM,
    "SUBSTRING(c.startDate, 0, 10) = @targetDate",
    Collections.singletonMap("targetDate", targetDate),
    Part.IgnoreCaseType.NEVER
);

// 构建查询对象
CosmosQuery query = new CosmosQuery(dateCriteria);
// 用cosmosTemplate执行查询，比如：
// List<YourEntity> results = cosmosTemplate.find(query, YourEntity.class);

注意事项 #

1. 自定义SQL片段里的c是Cosmos DB查询默认的容器别名，要保持一致。
2. 使用参数绑定（@targetDate）传递目标值，避免SQL注入，同时提升代码可维护性。
3. 如果实体类的startDate字段用注解指定了容器中的其他字段名，SQL里要使用实际的容器字段名。

优化建议 #

如果这类日期查询比较频繁，建议在文档中新增一个startDateOnly字段，直接存储2023-11-17这类纯日期字符串。这样查询时可以直接用普通的IS_EQUAL匹配，还能给该字段建索引，比使用SUBSTRING函数的查询性能更好——因为函数调用会导致Cosmos DB无法利用索引，全容器扫描的效率较低。

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