Suggesters · Elasticsearch 5.4 中文文檔

# Suggesters 原文鏈接 : [https://www.elastic.co/guide/en/elasticsearch/reference/5.0/search-suggesters.html](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/search-suggesters.html) 譯文鏈接 : [http://www.apache.wiki/display/Elasticsearch/Suggesters](http://www.apache.wiki/display/Elasticsearch/Suggesters) 貢獻者 : @Josh **suggest** 特征通過使用 **suggester** 基于所提供的文本來建議相似的術語。部分 **suggest** 功能還在開發中。 **suggest** 請求部分在 **_search** 請求中或者通過 **REST****_suggest** 斷點和查詢部分一起定義。 ``` POST twitter/_search { "query" : { "match": { "message": "tring out Elasticsearch" } }, "suggest" : { "my-suggestion" : { "text" : "trying out Elasticsearch", "term" : { "field" : "message" } } } } ``` 針對**_suggest** 端點執行的建議請求應忽略周圍的 **suggest** 元素，該元素僅在 **suggest** 請求是搜索的一部分時使用。 ``` POST _suggest { "my-suggestion" : { "text" : "tring out Elasticsearch", "term" : { "field" : "message" } } } ``` 每個請求可以指定幾個 **suggestions** 。每個 **suggestion** 用任意名稱標識。在下面的示例中，請求了兩個 **suggestions** 。 **my-suggest-1** 和 **my-suggest-2** 兩個 **suggestions** 使用術語 **suggester**，但有不同的 **test** 。 ``` POST _suggest { "my-suggest-1" : { "text" : "tring out Elasticsearch", "term" : { "field" : "message" } }, "my-suggest-2" : { "text" : "kmichy", "term" : { "field" : "user" } } } ``` 下面的 **suggest** 響應示例包括對于 **my-suggest-1** 和 **my-suggestion-2** 的 **suggest** 響應。每個**suggest** 部分包含條目（**entries**）。每個條目實際上是來自 **suggest** 文本的 **token** ，并且包含 **suggest** 文本中的 **suggest** 條目文本，原始的條目開始于 **suggest** 偏移（**offset**）和長度，并且如果找到任意數目的選項。 ``` { "_shards": ... "my-suggest-1": [ { "text": "tring", "offset": 0, "length": 5, "options": [ {"text": "trying", "score": 0.8, "freq": 1 } ] }, { "text": "out", "offset": 6, "length": 3, "options": [] }, { "text": "elasticsearch", "offset": 10, "length": 13, "options": [] } ], "my-suggest-2": ... } ``` 每個選項數組（**option array**）包含一個選項對象，其中包括 **suggest** 文本，其文檔頻率和分數與 **suggest** 輸入文本相比較。分數的意義取決于使用的**suggester**。術語 **suggester** 的分數是基于編輯（edit）距離。全局?**suggest**?文本為了避免重復 **suggest** 文本，可以定義全局文本。在下面的示例中，**suggest** 文本是全局定義的，并適用于 **my-suggest-1** 和 **my-suggest-2** 建議。 ``` POST _suggest { "text" : "tring out Elasticsearch", "my-suggest-1" : { "term" : { "field" : "message" } }, "my-suggest-2" : { "term" : { "field" : "user" } } } ``` 在上述示例中，**suggest** 文本也可以被指定為 **suggest** 特定選項。在 **suggestion** 級別上指定的 **suggest** 文本覆蓋全局級別上的 **suggest** 文本。