Azure Cosmos DB中使用ARRAY_CONTAINS查询卡片类型时，正确的自定义数组索引路径选择

针对你的场景，正确的索引路径应该是/cards/creditCardNumType/?，而不是/cards/*，下面给你详细解释原因和配置方式：

为什么选择这个路径？ #

你使用的查询是SELECT * FROM c WHERE ARRAY_CONTAINS(c.cards, {'creditCardNumType': 'visa-electron'}, true)，这里第三个参数设为true表示要做部分对象匹配——检查数组中是否存在任意一个对象包含指定的creditCardNumType键值对。

• 如果你配置/cards/*，Cosmos DB会索引数组里的整个对象（包括creditCardNum等无关字段），虽然能满足查询需求，但会浪费索引存储空间，查询效率也不如精准指向目标字段的索引。
• 而/cards/creditCardNumType/?这个路径的含义是：索引cards数组中每个元素的creditCardNumType字段（?通配符表示匹配数组内的任意元素），完全贴合你查询中需要筛选的逻辑，既能保证查询高效执行，又能最小化索引开销。

具体索引配置示例 #

因为你不想使用默认索引，需要手动配置索引策略，关闭自动索引并明确指定需要索引的路径。以下是完整的索引策略JSON：

{
  "indexingMode": "consistent",
  "automatic": false, // 关闭自动索引，避免默认行为
  "includedPaths": [
    // 核心筛选字段的索引，支持ARRAY_CONTAINS的部分匹配
    {
      "path": "/cards/creditCardNumType/?",
      "indexes": [
        {
          "kind": "Range",
          "dataType": "String",
          "precision": -1
        }
      ]
    },
    // 按需添加需要返回的其他字段（比如用户基本信息）
    {
      "path": "/id/?",
      "indexes": [
        {
          "kind": "Hash",
          "dataType": "String",
          "precision": -1
        }
      ]
    },
    {
      "path": "/firstName/?",
      "indexes": [
        {
          "kind": "Hash",
          "dataType": "String",
          "precision": -1
        }
      ]
    },
    {
      "path": "/lastName/?",
      "indexes": [
        {
          "kind": "Hash",
          "dataType": "String",
          "precision": -1
        }
      ]
    }
  ],
  "excludedPaths": [
    {
      "path": "/*" // 排除所有未明确包含的路径，彻底禁用默认索引
    }
  ]
}

额外注意事项 #

• 如果你不需要返回用户的基本信息（只需要判断是否存在符合条件的用户），可以只保留/cards/creditCardNumType/?在includedPaths中。
• 使用Range类型索引是因为ARRAY_CONTAINS的匹配需要进行字符串等值比较，Range索引能更好地支持这类操作；而返回字段用Hash索引足够，开销更低。
• 确保indexingMode设为consistent（默认值），保证索引和数据的一致性。

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