Azure Cognitive Search字段配置异常：仅Retrievable可选求助

核心原因：免费层（Free Tier）的字段属性限制 #

Azure Cognitive Search免费版对字段的可筛选（filterable）、可排序（sortable）、可分面（facetable）属性有严格限制：

• 每个索引最多只能有3个同时启用filterable/sortable/facetable的字段
• 这些字段若要启用全部三个高级属性，建议使用SimpleField类型（SearchableField在免费层下无法同时开启多个高级属性，这也是手动操作时选项禁用的直接原因）
• 限制与数据集大小无关，是免费层的固定配额限制

代码中的问题修正 #

1. 字段类型匹配错误
   你的数字字段（Total_no_of_records、No_of_failed_records）使用String类型，会导致排序、筛选逻辑异常，应改为对应数值类型：

   • 整数用SearchFieldDataType.Int32
   • 小数用SearchFieldDataType.Double

2. 调整字段类型与属性配置
   免费层下，需严格控制启用高级属性的字段数量，同时区分搜索字段与筛选/排序字段的类型。以下是修正后的字段配置示例：

fields=[
    # 仅用于全文搜索的字段，保留searchable属性
    SearchableField(name="rule_name", type=SearchFieldDataType.String, retrievable=True),
    SearchableField(name="rule_description", type=SearchFieldDataType.String, retrievable=True),
    
    # 需要filterable/sortable/facetable的字段，用SimpleField（控制在3个以内）
    SimpleField(name="Date_of_execution", type=SearchFieldDataType.String, facetable=True, filterable=True, sortable=True, retrievable=True),
    SimpleField(name="Data_Source", type=SearchFieldDataType.String, facetable=True, filterable=True, sortable=True, retrievable=True),
    SimpleField(name="Total_no_of_records", type=SearchFieldDataType.Int32, facetable=True, filterable=True, sortable=True, retrievable=True),
    
    # 剩余字段按需配置，避免超出配额
    SimpleField(name="No_of_failed_records", type=SearchFieldDataType.Int32, filterable=True, sortable=True, retrievable=True)
]

3. 索引重建注意事项
   • 字段属性无法在现有索引上直接修改，必须删除旧索引后重新创建
   • 若创建索引时返回配额错误，需进一步减少启用高级属性的字段数量

手动操作禁用的解决办法 #

免费层中，当尝试给超过3个字段启用filterable/sortable/facetable时，系统会自动禁用这些选项。解决步骤：

• 删除现有索引
• 重新创建索引时，仅给最核心的3个字段配置filterable/sortable/facetable属性
• 其余字段仅保留必要属性（如retrievable）

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