# Synonym Graph Token Filter（Synonym Graph 词元过滤器） 原文链接 : [https://www.elastic.co/guide/en/elasticsearch/reference/current/analysis-synonym-graph-tokenfilter.html](https://www.elastic.co/guide/en/elasticsearch/reference/current/analysis-synonym-graph-tokenfilter.html) 译文链接 : [http://www.apache.wiki/pages/viewpage.action?pageId=10028868](http://www.apache.wiki/pages/viewpage.action?pageId=10028868) 贡献者 : [fucker](/display/~caizhongjie)，[ApacheCN](/display/~apachecn)，[Apache中文网](/display/~apachechina) **警告：**此功能是实验性的，可能会在将来的版本中完全更改或删除。 Elastic 将采取最大的努力来解决任何问题，但实验功能不受SLA官方功能的支持。 **synonym_graph** 词元过滤器允许在分析过程中轻松处理同义词，包括多字同义词。 为了正确处理多字同义词，该词元过滤器在处理过程中创建 “**graph token stream**”。 有关此主题及其各种复杂性的更多信息，请阅读 **[Lucene’s TokenStreams are actually graphs](http://blog.mikemccandless.com/2012/04/lucenes-tokenstreams-are-actually.html)** 博客文章。 **提示：**该词元过滤器被设计为仅用作搜索分析器的一部分。 如果要在索引期间应用同义词，请使用标准 **[synonym token filter](http://www.apache.wiki/pages/viewpage.action?pageId=10028859)**。 同义词使用配置文件配置。 这是一个例子： ``` PUT /test_index { "settings": { "index" : { "analysis" : { "analyzer" : { "search_synonyms" : { "tokenizer" : "whitespace", "filter" : ["graph_synonyms"] } }, "filter" : { "graph_synonyms" : { "type" : "synonym_graph", "synonyms_path" : "analysis/synonym.txt" } } } } } } ``` 以上配置一个 **`search_synonyms` **（同义词）过滤器，其中包含一个路径 **analysis/synonym.txt**（相对于 **config **的位置）。 然后使用过滤器配置 **`search_synonyms` **同义词分析器。 其他设置有：**ignore_case**（默认为 **false**），和 **`expand` **（默认为 **true**）。 **tokenizer** 参数控制将用于标记同义词的分词器，并且默认为 **`whitespace`**  分词器。 支持两种同义词格式：**Solr，WordNet**。 #### **Solr synonyms** 以下是文件的示例格式： ``` # Blank lines and lines starting with pound are comments. # Explicit mappings match any token sequence on the LHS of "=>" # and replace with all alternatives on the RHS. These types of mappings # ignore the expand parameter in the schema. # Examples: i-pod, i pod => ipod, sea biscuit, sea biscit => seabiscuit # Equivalent synonyms may be separated with commas and give # no explicit mapping. In this case the mapping behavior will # be taken from the expand parameter in the schema. This allows # the same synonym file to be used in different synonym handling strategies. # Examples: ipod, i-pod, i pod foozball , foosball universe , cosmos lol, laughing out loud # If expand==true, "ipod, i-pod, i pod" is equivalent # to the explicit mapping: ipod, i-pod, i pod => ipod, i-pod, i pod # If expand==false, "ipod, i-pod, i pod" is equivalent # to the explicit mapping: ipod, i-pod, i pod => ipod # Multiple synonym mapping entries are merged. foo => foo bar foo => baz # is equivalent to foo => foo bar, baz ``` 您也可以在配置文件中直接给过滤器定义同义词（请注意使用 **synonyms **而不是 **synonyms_path **）： ``` PUT /test_index { "settings": { "index" : { "analysis" : { "filter" : { "synonym" : { "type" : "synonym_graph", "synonyms" : [ "lol, laughing out loud", "universe, cosmos" ] } } } } } } ``` 但是，建议使用 **synonyms_path **在文件中定义大型同义词集，因为内联指定会不必要地增加群集大小。 #### **WordNet synonyms** 基于 WordNet 格式的 同义词 可以如下使用格式声明： ``` PUT /test_index { "settings": { "index" : { "analysis" : { "filter" : { "synonym" : { "type" : "synonym_graph", "format" : "wordnet", "synonyms" : [ "s(100000001,1,'abstain',v,1,0).", "s(100000001,2,'refrain',v,1,0).", "s(100000001,3,'desist',v,1,0)." ] } } } } } } ``` 同时支持使用 **`synonyms_path`  **在文本中定义 **WordNet synonyms**。