索引API改變 · Elasticsearch 5.4 中文文檔

# 索引API改變原文鏈接 : [https://www.elastic.co/guide/en/elasticsearch/reference/5.0/breaking_50_index_apis.html](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/breaking_50_index_apis.html) 譯文鏈接 : [http://www.apache.wiki/pages/viewpage.action?pageId=4260773](http://www.apache.wiki/pages/viewpage.action?pageId=4260773) 貢獻者 : [片刻](/display/~jiangzhonglian) ## 在運行快照時關閉/刪除索引在以前的Elasticsearch版本中，在完整快照期間關閉或刪除索引會使快照失敗。在5.0中，關閉/刪除索引請求將失敗。部分快照的行為保持不變：仍然可以在部分快照期間關閉或刪除索引。然后將快照結果標記為部分。 ## Warmers 由于默認情況下的文檔值和基于磁盤的規范的幾個更改，加溫器不再有用。因此，加熱器和溫暖的API已被刪除：它不再可能注冊將在新的IndexSearcher發布之前運行的查詢。不要擔心，如果你有暖器定義在你的指數，當升級到5.0時，它們將被忽略。 ## 系統CPU統計信息最近的CPU使用率（百分比）已添加到在節點stats API和cat節點API下報告的操作系統統計數據。這里的斷裂更改是在節點stats響應中的os對象中有一個新對象。此對象稱為cpu，并包括percent和load_average作為字段。這會將以前是os對象中頂級字段的load_average字段移動到cpu對象。 load_average字段的格式已更改為字段1m，5m和15m分別表示一分鐘，五分鐘和十五分鐘加載的對象。如果這些字段中有任何字段不存在，則表示相應的值不可用。在cat節點的API響應中，默認情況下輸出cpu字段。之前的負載字段已被刪除，并被分別代表一分鐘，五分鐘和十五分鐘負載的load_1m，load_5m和load_15m替換。如果相應的值不可用，該字段將為null。最后，org.elasticsearch.monitor.os.OsStats的API已更改。 getLoadAverage方法已刪除。現在可以從OsStats.Cpu＃getLoadAverage獲取此值，但它不再是雙精度值，而是封裝1分鐘，5分鐘和15分鐘負載平均值的對象。此外，最近的CPU使用情況可以從OsStats.Cpu#getPercent獲取。 ## Suggest統計通過suggest在索引stats暴露的suggest統計信息已經與search統計信息合并。suggest統計信息作為search統計信息的一部分顯示。 ## 創建以 - 或+開頭的索引 Elasticsearch不再允許以 - 或+開頭創建索引，以便多索引匹配和擴展不會混淆。以前可能（但一個非常糟糕的主意）創建以連字符或加號開頭的索引。已存在這些前面的字符的任何索引將繼續正常工作。 ## 別名API / _aliases API不再支持indexRouting和index-routing，只有index_routing。它也不再支持searchRouting和index-routing，只有search_routing。這些被刪除，因為他們未經測試，我們更喜歡只有一個（顯而易見的）方式來做這樣的事情。 ## OpType創建沒有ID 從5.0索引，不再支持帶有?op_type=create?而不指定ID的文檔。 ## Flush API wait_if_ongoing標志默認已更改為true，導致_flush調用等待和阻止，如果另一個刷新操作當前正在同一個分片上運行。反過來，如果wait_if_ongoing設置為false，并且另一個flush操作已經運行，則會跳過flush并且shard flush調用將立即返回而沒有任何錯誤。在以前的版本中，flush_not_allowed異常為每個跳過的分片報告。