OpenSearch中flat_object字段无法生成terms聚合的问题咨询

结论 #

OpenSearch 2.11.0版本的flat_object类型不支持对嵌套子字段直接执行terms聚合，这是它与Elasticsearch flattened类型的关键差异之一。

原因说明 #

OpenSearch的flat_object类型在索引时会将整个对象序列化为单一字符串值存储，不会为对象内的每个子字段单独建立可用于聚合的倒排索引结构。而Elasticsearch的flattened类型会为每个子字段生成独立的索引项，因此支持对子字段的聚合操作。

解决方案 #

如果需要对labels.colour这类子字段执行聚合，可采用以下两种方案：

方案1：改用object类型（明确映射子字段） #

若提前知晓子字段结构，可直接将labels定义为object类型，并指定子字段为适合聚合的keyword类型：

PUT test_agg_1
{
  "mappings": {
    "properties": {
      "zip5": {
        "type": "keyword"
      },
      "labels": {
        "type": "object",
        "properties": {
          "colour": {
            "type": "keyword"
          }
        }
      }
    }
  }
}

方案2：使用运行时字段（runtime_field）提取值 #

若无法提前定义子字段映射，可通过运行时字段在查询阶段提取labels.colour的值，再基于该字段执行聚合：

GET test_agg_1/_search
{
  "track_total_hits": true,
  "runtime_mappings": {
    "labels_colour": {
      "type": "keyword",
      "script": """
        def colour = params._source.labels?.colour;
        if (colour != null) emit(colour);
      """
    }
  },
  "query": {
    "bool": {
      "must": [
        {
          "bool":{
            "should": [
              {"match": {"labels.colour": "blue"}},
              {"match": {"labels.colour": "red"}}
            ]
          }
        },
        {
          "terms": {"zip5":["1001","1000"]}
        }
      ]
    }
  },
  "aggs":{
    "colour":{
      "terms":{"field":"labels_colour"}
    },
    "zip":{
      "terms":{"field":"zip5"}
    }
  }
}

补充说明 #

后续OpenSearch版本是否会新增flat_object子字段的聚合支持，需关注官方更新日志。当前版本下，上述两种方案是最直接的解决途径。

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