# Common Grams Token Filter(近義詞詞元過濾器) 原文鏈接 :[https://www.elastic.co/guide/en/elasticsearch/reference/5.4/analysis-common-grams-tokenfilter.html](https://www.elastic.co/guide/en/elasticsearch/reference/5.4/analysis-common-grams-tokenfilter.html) 譯文鏈接 : [http://www.apache.wiki/pages/viewpage.action?pageId=10028048](http://www.apache.wiki/pages/viewpage.action?pageId=10028048) 貢獻者 : [李亞運](/display/~liyayun)，[ApacheCN](/display/~apachecn)，[Apache中文網](/display/~apachechina) ## 簡述 此過濾器，用于為經常出現的術語生成二進制碼。?單項仍被索引。?當我們不想完全忽略常用術語時，它可以用作“?[停止令牌過濾器”](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/analysis-stop-tokenfilter.html)的替代方法。如"the quick brown is a fox",將被過濾成??"the", "the_quick", "quick", "brown", "brown_is", "is_a", "a_fox", "fox"。假設“the”，“is”和“a”是常用詞。 當啟用`query_mode`時，過濾器將刪除常用單詞和單個術語，后跟通用單詞。?應在搜索分析器中啟用此參數。如，"the quick brown is a fox" 將被過濾成?"the_quick", "quick", "brown_is", "is_a", "a_fox", "fox"。 ## 參數 以下是常用設置： | 設置 | 描述 | | --- | --- | | `common_words` | 要使用的常用詞列表。 | | `common_words_path` | 路徑（相對于`config`位置，或絕對）到常用單詞列表。?每個單詞應該在自己的“行”（用換行符分隔）。?該文件必須是UTF-8編碼。 | | `ignore_case` | 如果為真，通用單詞匹配將不區分大小寫（默認為`false`?）。 | | `query_mode` | 生成二進制，然后刪除常用單詞和單個術語，后跟一個通用單詞（默認為`false`?）。 | 注意，?`common_words`或`common_words_path`字段是必需的。 ## 示例 如下所示： ``` index : analysis : analyzer : index_grams : tokenizer : whitespace filter : [common_grams] search_grams : tokenizer : whitespace filter : [common_grams_query] filter : common_grams : type : common_grams common_words: [a, an, the] common_grams_query : type : common_grams query_mode: true common_words: [a, an, the] ```