過濾器改變 · Elasticsearch 5.4 中文文檔

# 過濾器改變原文鏈接 : [https://www.elastic.co/guide/en/elasticsearch/reference/5.0/breaking_50_percolator.html](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/breaking_50_percolator.html) 譯文鏈接 : [http://www.apache.wiki/pages/viewpage.action?pageId=4260766](http://www.apache.wiki/pages/viewpage.action?pageId=4260766) 貢獻者 : [片刻](/display/~jiangzhonglian) ## 滲濾器接近實時以前的滲濾器被實時激活，即，一旦它們被索引。現在，只要刷新了索引，percolate查詢的更改就會在接近實時的時間內可見。需要進行此更改，因為在從5.0開始創建的索引中，滲透器查詢中使用的術語會自動編入索引，以便在滲透期間進行更有效的查詢選擇。 ## 滲濾和多滲濾API 過濾器和多滲析物API已被棄用，并將在下一個主要版本中刪除。這些API已被可以在搜索和多搜索API中使用的percolate查詢所替代。 ## 滲透器字段映射 .percolator類型不能再用于索引percolator查詢。相反，必須在對過濾器查詢進行索引之前配置[過濾器字段類型](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/percolator.html)。仍然可以使用在5.0.0之前的版本上創建的.percolator類型的索引，但新索引不再接受.percolator類型。但是強烈建議重新索引包含在升級到Elasticsearch 5之前創建的percolate查詢的任何索引。通過這樣做，滲透查詢利用提取的術語從滲透器查詢中提取的percolate字段類型，并且可能執行速度快多倍。 ## Percolate文檔映射 percolate查詢不再修改映射。在percolate API之前可以用來動態地引入新的字段到基于正被percolated的文檔中的字段的映射。這不再工作，因為這些未映射字段不會持久保存在映射中。 ## 由搜索返回的滲透文檔具有.percolate類型的文檔先前已從搜索響應中排除，除非在搜索請求中明確指定.percolate類型。現在，過濾器文檔的處理方式與任何其他文檔相同，并由搜索請求返回。 ## 滲透現有文檔當滲透現有文檔時，也不再允許在滲出查詢中指定文檔作為源。之前的percolate API允許并忽略現有文檔。 ## Percolate統計濾液的數據已被刪除。這是因為滲透器不再緩存滲透器查詢。 ## 包含具有現在范圍的范圍查詢的Percolator查詢滲透器不再接受包含范圍查詢的滲透查詢，范圍查詢的范圍基于當前時間（使用now）。 ## 包含腳本的Percolator查詢包含沒有指定明確語言的腳本（例如：script query或function_score查詢腳本函數）的Percolator查詢將使用版本5.0及更高版本的Painless腳本語言。在版本5.0之前創建的索引中存儲的滲透器查詢中未設置顯式語言的腳本將使用已在script.legacy.default_lang設置中配置的語言。此設置默認為Groovy腳本語言，這是5.0之前的版本的默認語言。如果您的默認腳本語言不同，請將script.legacy.default_lang設置設置為您以前使用的語言。為了使用新的percolator字段類型，所有滲透器查詢應重新索引到一個新的索引。當使用沒有明確語言定義到新索引的腳本重新建立過濾器查詢索引時，應該執行以下兩項操作之一以使腳本工作：*（推薦方法）在重建索引過濾器文檔時，將腳本遷移到無痛腳本語言。 *或在腳本中添加lang參數，并設置它們寫入這些腳本的語言。 ## Java客戶端滲透器不再是核心彈性搜索依賴項的一部分。它已移至滲透器模塊。因此，當使用來自Java客戶端的過濾器功能時，新的滲透器模塊也應該在類路徑上。此外，傳輸客戶端應該將滲析器模塊作為插件加載： ``` TransportClient transportClient = TransportClient.builder() .settings(Settings.builder().put("node.name", "node")) .addPlugin(PercolatorPlugin.class) .build(); transportClient.addTransportAddress( new InetSocketTransportAddress(new InetSocketAddress(InetAddresses.forString("127.0.0.1"), 9300)) ); ``` 已刪除來自Client界面的滲濾器和多滲出相關方法。這些API已被棄用，建議在搜索或多搜索API中使用percolate查詢。然而，滲出物和多滲出物API仍然可以從Java客戶端使用。使用滲濾液請求： ``` PercolateRequest request = new PercolateRequest(); // set stuff and then execute: PercolateResponse response = transportClient.execute(PercolateAction.INSTANCE, request).actionGet(); ``` 使用滲濾請求生成器： ``` PercolateRequestBuilder builder = new PercolateRequestBuilder(transportClient, PercolateAction.INSTANCE); // set stuff and then execute: PercolateResponse response = builder.get(); ``` 使用多滲濾請求： ``` MultiPercolateRequest request = new MultiPercolateRequest(); // set stuff and then execute: MultiPercolateResponse response = transportClient.execute(MultiPercolateAction.INSTANCE, request).get(); ``` 使用多滲濾請求生成器： ``` MultiPercolateRequestBuilder builder = new MultiPercolateRequestBuilder(transportClient, MultiPercolateAction.INSTANCE); // set stuff and then execute: MultiPercolateResponse response = builder.get(); ```