如何在Elasticsearch中动态配置同义词无需重建索引？

你的具体疑问解答 #

1. 查询"celular"是否会匹配所有同义词？ #

当前你的同义词规则是smartphone, telefone => celular，这是单向映射规则：只有搜索smartphone或telefone时，会被转换成celular去匹配索引中的celular文档；反过来搜索celular时，不会自动扩展为smartphone和telefone，所以无法匹配索引里的smartphone、telefone条目。

如果需要双向等价匹配，要把规则改成等价组形式：

celular, smartphone, telefone

这样不管搜索其中哪个词，都会被扩展成所有等价词去匹配索引中的对应内容。

2. 修改同义词文件后调用_reload_search_analyzers能否生效？ #

这取决于你的同义词过滤器是用在索引分析器还是搜索分析器：

• 如果之前用的是索引分析器：修改文件后调用API没用，必须重建索引才能让新同义词生效（因为旧文档已经按旧规则完成了索引）。
• 如果已经改成搜索分析器，且过滤器配置了reloadable: true：修改sinonimos.txt后调用_reload_search_analyzersAPI，新规则会立即生效，无需重建索引或关闭索引。

核心问题：动态实现同义词的正确方案 #

要实现动态添加/删除同义词无需重建索引，必须满足两个核心条件：同义词过滤器仅用于搜索分析器 + 开启过滤器的可重载配置，具体步骤如下：

1. 配置可重载的搜索同义词分析器 #

在索引的设置中创建专用的搜索分析器，同义词过滤器仅用于该分析器，同时开启reloadable: true：

PUT /你的索引名/_settings
{
  "analysis": {
    "filter": {
      "sinonimos": {
        "type": "synonym",
        "explicit": false,
        "synonyms_path": "sinonimos.txt",
        "reloadable": true  // 允许动态重载同义词文件
      }
    },
    "analyzer": {
      "search_synonyms": {
        "tokenizer": "standard",
        "filter": ["lowercase", "sinonimos"]
      }
    }
  }
}

2. 配置字段映射，指定搜索分析器 #

确保字段的索引分析器不包含同义词过滤器，仅在搜索时使用上面的分析器：

PUT /你的索引名/_mapping
{
  "properties": {
    "descricao": {
      "type": "text",
      "analyzer": "standard",  // 索引时不处理同义词，保留原始词条
      "search_analyzer": "search_synonyms"  // 搜索时应用同义词转换
    }
  }
}

3. 动态更新同义词的操作流程 #

1. 修改elasticsearch/config/sinonimos.txt文件，比如添加cellphone到等价组：

   celular, smartphone, telefone, cellphone
   

2. 调用重载搜索分析器的API，让新规则生效：

   POST /你的索引名/_reload_search_analyzers
   

3. 验证：此时搜索cellphone、smartphone等任意同义词，都能匹配到索引中所有对应的文档。

关键注意事项 #

• 索引时同义词的弊端：如果把同义词过滤器用在索引分析器，索引时就会将同义词转换为目标词存储，后续修改同义词规则必须重建所有文档才能生效，完全无法动态更新。
• 搜索时同义词的优势：仅在搜索阶段对查询词做同义词转换，不影响已索引的文档，配合reloadable: true可以实现完全动态的同义词管理，无需重建索引或关闭索引。

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