使用Cosmos DB按分区键精确查询失败，范围查询可行，求原因

你的问题大概率是文档中CustomerId的类型不一致导致的——部分文档的CustomerId是字符串类型（比如"500"），而另一部分是数字类型（比如500）。

为什么会出现这种差异？ #

Cosmos DB的查询在处理精确匹配（=）时会严格区分数据类型：

• 当你执行SELECT * from c where c.CustomerId = "500"时，只会返回CustomerId是字符串"500"的文档，那些CustomerId是数字500的文档会被直接过滤掉。
• 而范围查询（>/<）时，Cosmos DB会进行隐式类型转换，把数字类型的CustomerId转换成字符串后再做字典序比较。数字500转成字符串就是"500"，自然会落在"499"和"501"之间，所以范围查询能返回所有类型的目标文档。

另外你提到按分区键+行键查询正常，是因为行键的精确匹配会帮你定位到具体文档，不管分区键的类型（只要行键正确），但单独的分区键精确查询就会受类型严格匹配的影响。

验证方法 #

你可以执行下面的查询来确认类型差异：

SELECT DISTINCT VALUE TYPE(c.CustomerId) FROM c WHERE c.CustomerId > "499" AND c.CustomerId < "501"

如果返回结果包含"String"和"Number"两种类型，就坐实了这个问题。

解决方案 #

1. 统一数据类型（长期最优解）：把所有文档的CustomerId统一为字符串类型（或者统一为数字类型，保持一致即可）。分区键的类型必须在同一分区键路径下保持一致，否则会持续出现这类查询异常，还可能影响后续的索引、事务等操作。
   • 可以通过批量更新脚本修正现有文档的类型。
2. 修改查询语句（临时兼容方案）：如果暂时无法修改数据，可以用类型转换函数来兼容两种类型：

   SELECT * FROM c WHERE STRING(c.CustomerId) = "500"
   

   这个查询会把所有CustomerId转换成字符串后再匹配，能返回所有类型的目标文档，但注意这样的查询会失去分区键精确匹配的性能优势（因为需要全分区扫描），只建议临时使用。

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