Lowercase 规范化器

Lowercase 规范化器 #

lowercase 是 Easysearch 内置的规范化器，将 keyword 字段的整个值转换为小写形式。无需在 settings 中定义即可直接使用。

使用方式 #

在映射中直接引用：

PUT my-index
{
  "mappings": {
    "properties": {
      "status": {
        "type": "keyword",
        "normalizer": "lowercase"
      }
    }
  }
}

效果演示 #

索引文档：

PUT my-index/_doc/1
{
  "status": "OK"
}

PUT my-index/_doc/2
{
  "status": "Ok"
}

PUT my-index/_doc/3
{
  "status": "ok"
}

查询时，无论使用哪种大小写形式都能匹配所有文档：

GET my-index/_search
{
  "query": {
    "term": {
      "status": "OK"
    }
  }
}

三个文档都会被返回，因为 "OK"、"Ok"、"ok" 在索引时都被归一化为 "ok"。

对聚合的影响 #

GET my-index/_search
{
  "size": 0,
  "aggs": {
    "status_counts": {
      "terms": {
        "field": "status"
      }
    }
  }
}

聚合结果中只会出现 "ok" 一个桶（而非三个不同的大小写变体），计数为 3。

等价的自定义配置 #

lowercase 内置规范化器等价于以下自定义配置：

PUT my-index
{
  "settings": {
    "analysis": {
      "normalizer": {
        "my_lowercase": {
          "type": "custom",
          "filter": ["lowercase"]
        }
      }
    }
  }
}

如果只需要小写转换，推荐直接使用内置的 lowercase，更简洁。

适用场景 #

场景示例
状态码匹配"OK" / "ok" / "Ok" 视为相同
标签归一化"JavaScript" / "javascript" 聚合在一起
枚举值查询"ACTIVE" / "active" 无差别匹配
用户名不区分大小写"Admin" / "admin" 指向同一用户

限制 #

  • 仅做小写转换，不处理变音符号（"Naïve" → "naïve" 而非 "naive"）
  • 不做 Unicode 归一化或字符映射
  • 如需更复杂的归一化逻辑，请使用 自定义规范化器
©INFINI.LTD, All Rights Reserved.