Azure Cosmos DB含斜杠字段查询加ORDER BY报输入无效错误

问题背景 #

我们在Azure Cosmos容器中存储如下结构的数据：

• 按ProcessDataId分组，单分组文档量超10万
• 分区键为id
• 索引配置为全路径包含的一致索引
• 文档中data字段下存在带斜杠的属性（如class/、line/qa）

执行带ORDER BY的查询时触发报错：{"Errors":["One of the specified inputs is invalid"]}，移除ORDER BY则查询正常。经排查，字段名中的斜杠是问题根源，但我们无法修改现有数据，需要可行的替代方案。

解决方案 #

1. 子查询+字段别名 #

通过子查询将需要排序或过滤的带斜杠字段提取为别名，在外层查询中使用别名操作，避免解析器直接处理带斜杠的字段名：

SELECT sub.data
FROM (
    SELECT 
        c.data,
        c.data.confidenceValue AS sortValue,
        c["data"]["class/"] AS classVal,
        c["data"]["line/qa"] AS lineVal,
        c["data"]["riskcodes/qa"] AS riskCodesVal
    FROM c
    WHERE c.ProcessDataId = "37f33e4c-7ab6-4a4e-9102-e085a9663612"
) sub
WHERE sub.classVal = "Combined" 
  AND sub.lineVal = "Combined" 
  AND sub.riskCodesVal = "Combined"
ORDER BY sub.sortValue DESC
OFFSET 0 LIMIT 6

2. 用户定义函数(UDF)封装字段访问 #

创建UDF统一处理带特殊字符的字段路径解析，规避查询语句中直接使用带斜杠的字段名：

步骤1：创建UDF

function getNestedField(document, fieldPath) {
    const pathSegments = fieldPath.split('.');
    let current = document;
    for (const segment of pathSegments) {
        if (!current) break;
        current = current[segment];
    }
    return current;
}

步骤2：使用UDF执行查询

SELECT c.data
FROM c
WHERE c.ProcessDataId = "37f33e4c-7ab6-4a4e-9102-e085a9663612"
  AND udf.getNestedField(c, "data.class/") = "Combined"
  AND udf.getNestedField(c, "data.line/qa") = "Combined"
  AND udf.getNestedField(c, "data.riskcodes/qa") = "Combined"
ORDER BY udf.getNestedField(c, "data.confidenceValue") DESC
OFFSET 0 LIMIT 6

注意：UDF会引入一定性能开销，针对超10万条文档的场景，建议结合索引优化使用。

3. 显式配置索引路径 #

当前全路径索引可能未正确识别带斜杠的字段路径，显式添加包含路径可让Cosmos DB正确解析这些字段：

{
    "indexingMode": "consistent",
    "automatic": true,
    "includedPaths": [
        {
            "path": "/*"
        },
        {
            "path": "/data/class//?"
        },
        {
            "path": "/data/line/qa//?"
        },
        {
            "path": "/data/riskcodes/qa//?"
        },
        {
            "path": "/data/confidenceValue//?"
        }
    ]
}

配置完成后，重新执行原查询即可正常运行。

报错原因 #

Cosmos DB的SQL查询解析器会将字段名中的斜杠误识别为路径分隔符（类似JSON路径的层级分隔），导致字段路径解析错误。在ORDER BY子句中，解析逻辑更为严格，进而触发"无效输入"的报错。

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