# Shingle Token Filter（Shingle 詞元過濾器） 原文鏈接 : [https://www.elastic.co/guide/en/elasticsearch/reference/current/analysis-shingle-tokenfilter.html](https://www.elastic.co/guide/en/elasticsearch/reference/current/analysis-shingle-tokenfilter.html) 譯文鏈接 : [http://www.apache.wiki/pages/viewpage.action?pageId=10028515](http://www.apache.wiki/pages/viewpage.action?pageId=10028515) 貢獻者 : [fucker](/display/~caizhongjie)，[ApacheCN](/display/~apachecn)，[Apache中文網](/display/~apachechina) **shingle**?類型的詞元過濾器，用于從詞元流中構建?**shingles**?（**token n-grams**）。 換句話說，它創建詞元的組合作為單個詞元。 例如，句子 “**please divide this sentence into shingles**” ，可能會被劃分為詞組“**please divide**”，“**divide this**”，“**this sentence**”，“**sentence into**”和“**into shingles**”。 此過濾器通過插入?**filler tokens**（使用“_”的詞元）來處理游標自增 > 1。游標不從0開始。 以下是?**shingle**?類型的詞元過濾器的可選設置： | 設置 | 描述 | | --- | --- | | `max_shingle_size` | 最大的 **shingle** 數量. 默認?**`2`**. | | `min_shingle_size` | 最小的 **shingle** 數量. 默認**`2`**. | | `output_unigrams` | 如果為?**`true`?** 輸出將會包含輸入的 **tokens (unigrams)** 以及 **shingles**. 默認?**`true`**. | | `output_unigrams_if_no_shingles` | 如果?**`output_unigrams`?**?為 **`false`**?，如果沒有可用的 **shingles** 輸出將會包含輸入的 **tokens (unigrams)**. **提示** 如果?**`output_unigrams`?**?為 **true** 當前設置不生效. 默認?**`false`**. | | `token_separator` | 連接相鄰的詞元生成詞組的字符串. 默認?`" "`. | | `filler_token` | 用于替換流中每個沒有實際詞元的位置的字符串。例如，當 **stop** 過濾器與 **`shingle`**?過濾器一起使用時，如果位置增量大于1\. 默認?`"_"` |