Plugin改變 · Elasticsearch 5.4 中文文檔

# Plugin改變原文鏈接 : [https://www.elastic.co/guide/en/elasticsearch/reference/5.0/breaking_50_plugins.html](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/breaking_50_plugins.html) 譯文鏈接 : [http://www.apache.wiki/pages/viewpage.action?pageId=4260816](http://www.apache.wiki/pages/viewpage.action?pageId=4260816) 貢獻者 : [片刻](/display/~jiangzhonglian) 命令bin/plugin已重命名為bin/elasticsearch-plugin。插件ZIP存檔的結構已更改。所有的插件文件必須包含在名為elasticsearch的頂級目錄中。如果你使用gradle build，這個結構是自動生成的。 ## 插件隔離隔離選項已刪除。每個插件都有自己的類加載器。 ## 已刪除網站插件網站插件已刪除。網站插件應重新實現為Kibana插件。 ## 刪除多播插件組播已刪除。使用單播發現，或其中一個云發現插件。 ## 具有自定義查詢實現的插件實現自定義查詢的插件需要在其QueryParser子類中實現fromXContent(QueryParseContext)方法，而不是解析。此方法將處理將查詢從XContent格式解析為中間查詢表示，可以在二進制格式的節點之間流式傳輸，有效地在java api中使用查詢對象。此外，查詢構建器需要注冊為NamedWriteable。這一切都是通過實現SearchPlugin接口并覆蓋getQueries方法來完成的。然后，查詢對象可以通過新的toQuery（QueryShardContext）方法將自身轉換為lucene查詢，該方法返回要在數據節點上執行的lucene查詢。同樣，實現自定義分數函數的插件需要在ScoreFunctionParser子類中實現fromXContent（QueryParseContext）方法，而不是解析。此方法將處理從XContent格式的函數解析為中間函數表示，可以在二進制格式的節點之間流式傳輸，有效地在java api中使用的函數對象。函數對象然后可以通過新的toFunction（QueryShardContext）方法將自身轉換為lucene函數，該方法返回要在數據節點上執行的lucene函數。 ## Cloud AWS插件改變 Cloud AWS插件已分為兩個插件： * [Discovery EC2 plugin](https://www.elastic.co/guide/en/elasticsearch/plugins/5.0/discovery-ec2.html) * [Repository S3 plugin](https://www.elastic.co/guide/en/elasticsearch/plugins/5.0/repository-s3.html)? 兩個插件的代理設置已重命名： * 從cloud.aws.proxy_host ? ? ? ? 到 ?cloud.aws.proxy.host * 從cloud.aws.ec2.proxy_host ?到 ?cloud.aws.ec2.proxy.host * 從cloud.aws.s3.proxy_host ? ?到 ?cloud.aws.s3.proxy.host * 從cloud.aws.proxy_port ? ? ? ? 到 ?cloud.aws.proxy.port * 從cloud.aws.ec2.proxy_port ?到 ?cloud.aws.ec2.proxy.port * 從cloud.aws.s3.proxy_port ? ?到 ?cloud.aws.s3.proxy.port ## Cloud Azure插件改變 Cloud Azure插件已分為三個插件： * [Discovery Azure plugin](https://www.elastic.co/guide/en/elasticsearch/plugins/5.0/discovery-azure-classic.html) * [Repository Azure plugin](https://www.elastic.co/guide/en/elasticsearch/plugins/5.0/repository-azure.html) * [Store SMB plugin](https://www.elastic.co/guide/en/elasticsearch/plugins/5.0/store-smb.html) 如果你使用cloud-azure插件進行快照和恢復，你在elasticsearch.yml中： ``` cloud: azure: storage: account: your_azure_storage_account key: your_azure_storage_key ``` 您現在需要為存儲詳細信息指定唯一的ID，因為您可以定義多個存儲帳戶： ``` cloud: azure: storage: my_account: account: your_azure_storage_account key: your_azure_storage_key ``` ## Cloud GCE插件更改 Cloud GCE插件已重命名為[Discovery GCE](https://www.elastic.co/guide/en/elasticsearch/plugins/5.0/discovery-gce.html)插件。 ## 刪除了按查詢刪除的插件已刪除“按查詢刪除”插件，以便在核心中使用新的[按查詢API刪除](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/docs-delete-by-query.html)的實現。它現在支持限制，重試和取消，但不再支持超時。而是使用?[cancel API](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/docs-delete-by-query.html#docs-delete-by-query-cancel-task-api "Works with the Cancel Task APIedit")?取消運行時間過長的刪除。 ## Mapper附件插件已棄用映射程序附件已被棄用。用戶現在應該使用?`[ingest-attachment](https://www.elastic.co/guide/en/elasticsearch/plugins/5.0/ingest-attachment.html)?`插件。 ## 傳遞Java系統屬性以前，可以通過將-D樣式參數直接傳遞給插件腳本來將Java系統屬性傳遞給插件命令。不再允許這樣做，并且必須通過ES_JAVA_OPTS傳遞此類系統屬性。 ## 自定義插件路徑通過path.plugins指定自定義插件路徑的功能已刪除。 ## ScriptPlugin 注冊自定義腳本的插件應該實現ScriptPlugin并刪除其?onModule(ScriptModule)實現。 ## AnalysisPlugin 注冊自定義分析組件的插件應該實現AnalysisPlugin并刪除其?`onModule(AnalysisModule)?`實現。 ## MapperPlugin 注冊自定義映射器的插件應實現MapperPlugin并刪除其 onModule(IndicesModule)?實現。 ## ActionPlugin 注冊自定義操作的插件應該實現ActionPlugin并刪除其 onModule(ActionModule)?實現。注冊自定義RestHandler的插件應該實現`ActionPlugin并刪除它們的 `onModule(NetworkModule)`??實現。 ## SearchPlugin 注冊自定義搜索時間行為的插件（Query，Suggester，ScoreFunction，FetchSubPhase，Highlighter等）應實現SearchPlugin并刪除其 onModule(SearchModule)?實現。 ## SearchParseElement SearchParseElement接口已刪除。自定義搜索請求部分只能在ext元素下提供。插件可以通過提供SearchPlugin.SearchExtSpec來插入自定義解析器，它包含一個SearchExtParser實現，它可以將`XContent`解析成一個SearchExtBuilder實現。解析現在發生在協調節點中。解析的結果與搜索請求的其余部分一起通過傳輸層串行化到數據節點，并且存儲在搜索上下文中以供稍后檢索。 ## 測試自定義插件 ESIntegTestCase＃pluginList已刪除。使用Arrays.asList。現在不需要所有的插件都需要Java 1.8。 ## Mapper-Size插件元數據字段_size在聚合，腳本和為2.x中創建的索引排序時不可訪問。如果應用程序中需要這些功能，則需要使用Elasticsearch 5.x重新索引數據。