搜索和查詢DSL改變 · Elasticsearch 5.4 中文文檔

# 搜索和查詢DSL改變原文鏈接 : [https://www.elastic.co/guide/en/elasticsearch/reference/5.3/breaking_50_search_changes.html](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/breaking_50_search_changes.html) 譯文鏈接 : [http://www.apache.wiki/pages/viewpage.action?pageId=4260751](http://www.apache.wiki/pages/viewpage.action?pageId=4260751) 貢獻者 : [片刻](/display/~jiangzhonglian) [ApacheCN](/display/~apachecn) [Apache中文網](/display/~apachechina) ## 搜索類型 search_type = count ?**removed** 計數搜索類型自2.0.0版起已被棄用，現在已被刪除。為了獲得相同的好處，您只需要將size參數的值設置為0。例如，以下請求： ``` GET /my_index/_search?search_type=count { "aggs": { "my_terms": { "terms": { "field": "foo" } } } } ``` 可替換為： ``` GET /my_index/_search { "size": 0, "aggs": { "my_terms": { "terms": { "field": "foo" } } } } ``` search_type = scan ?**removed** 掃描搜索類型自2.1.0版以來已棄用，現在已刪除。現在可以通過執行以_doc順序排列文檔的滾動請求來實現此搜索類型的所有好處，例如： ``` GET /my_index/_search?scroll=2m { "sort": [ "_doc" ] } ``` 按 _doc 排序的滾動請求已優化，以便從上一個請求停止的位置更有效地恢復，因此這將具有與前一個掃描搜索類型相同的性能特性。 ## 搜索分片限制在5.0中，Elasticsearch拒絕將查詢超過1000個分片副本（初級或副本）的請求。原因是這樣大量的分片使協調節點的工作非常耗費CPU和內存。組織數據通常是一個更好的主意，因為有較少的較大的分片。如果您想繞過此限制（不鼓勵），可以將 action.search.shard_count.limit 集群設置更新為更大的值。 ## fields參數 fields參數已替換為stored_fields。 stored_fields參數將只返回存儲的字段 - 它將不再從_source中提取值。 ## fielddata_fields參數 fielddata_fields已棄用，請改用參數docvalue_fields。 ## search-exists API 已刪除搜索存在api已被刪除，有利于使用大小設置為0和terminate_after設置為1的搜索API。 ## 已棄用的查詢已刪除以下已棄用的查詢已刪除： filtered ? ? 使用bool查詢，它支持過濾器子句。 and ? ? 請在bool查詢中使用must子句。 or ? ? 請在bool查詢中使用should子句。 missing ? ? 使用否定的exists查詢。（也從query_string查詢中刪除_missing_） limit ? ? 請改用terminate_after參數。 fquery ? ? 在過濾器和查詢合并后過時。 query ? ? 在過濾器和查詢合并后過時。 query_binary ? ? 未歸檔，已刪除。 filter_binary ? ? 未歸檔，已刪除。 ## 查詢的變化 * 不支持的查詢（例如geo_point字段上的字詞查詢）現在會失敗，而不會返回任何匹配。 * 刪除了對數字，日期和IP字段上的模糊查詢的支持，而是使用范圍查詢。 * 刪除了對_uid和_id字段的范圍和前綴查詢的支持。 * 查詢未索引的字段現在將失敗，而不返回任何匹配。 * 刪除了對模糊查詢中已棄用的min_similarity參數的支持，有利于模糊性。 * 刪除了對query_string查詢中已棄用的fuzzy_min_sim參數的支持，有利于模糊性。 * 刪除了對完成suggester中已棄用的edit_distance參數的支持，有利于模糊性。 * 刪除了對索引查詢中已棄用的過濾器和no_match_filter字段的支持，贊成查詢和no_match_query。 * 刪除了對嵌套查詢中已棄用的過濾字段的支持，有利于查詢。 * 刪除了對已棄用的minimum_should_match和disable_coord在術語查詢中的支持，而改為使用bool查詢。也刪除了對已棄用的執行參數的支持。 * 刪除了對function_score查詢中的頂級過濾器元素的支持，由查詢替換。 * 已不推薦使用span_near查詢的collect_payloads參數。有效載荷將在需要時加載。 * 已刪除嵌套和has_child查詢的score_type參數，有利于score_mode。 has_parent的score_mode參數已棄用，有利于score boolean參數。此外，已經去除了總分數模式，有利于和模式。 * 當has_child查詢的max_children參數設置為0時，沒有允許匹配的子文檔數量的上限。現在，0實際上意味著允許零個子文檔。如果不需要上限，那么不應該指定max_children參數。 * 如果禁用_field_names字段，則現有查詢將失敗。 * 如果cross_fields，phrase或phrase_prefix類型使用模糊性，multi_match查詢將失敗。此參數未記錄，并且在這些類型的multi_match之前默認忽略。 * 不再支持GeoPolygonQuery中的coerce，normalize，ignore_malformed參數。請改用參數validation_method。 * 對GeoDistanceQuery中的coerce，normalize，ignore_malformed參數的不再支持。請改用參數validation_method。 * 不再支持在GeoBoundingBoxQuery中的coerce，normalize，ignore_malformed參數。請改用參數validation_method。 * 不再支持geo_distance_range查詢，應該將其替換為geo_distance bucket聚合。 ## 頂級過濾器參數刪除了對搜索api中已棄用的頂級過濾器的支持，由post_filter替換。 ## 高亮刪除了對多個高亮名稱的支持，唯一支持的是：plain，fvh和postings。 ## 術語向量API 術語向量API不再保持映射中的未映射字段。術語向量API的dfs參數已完全刪除。詞向量不再支持分布式文檔頻率。 ## 分類 reverse參數已被刪除，有利于使用order選項明確指定排序順序。為了支持validation_method；coerce和ignore_malformed參數已被棄用。 ## 內部命中 * 頂級內部匹配語法已刪除。內部命中現在只能指定為nested，has_child和has_parent查詢的一部分。之前只能使用頂級內部命中的用例現在可以使用查詢dsl中定義的內部命中來完成。 * 嵌套查詢中的內部命中的源過濾需要完整的字段名稱，而不是相對字段名稱。現在，這對于在搜索API中的其他位置進行源過濾是一致的。 * 嵌套的內部點擊將不再包含_index，_type和_id鍵。對于嵌套內部命中，這些值總是與根搜索命中的_index，_type和_id鍵相同。 * 父/子內部匹配現在將不再包含_index鍵。對于父/子內部命中，_index鍵始終與父搜索命中相同。 ## 查詢 Profiler 在對查詢查詢的響應中，query_type已重命名為type，lucene已重命名為description。這些更改已經完成，所以響應格式更加友好，以支持其他類型的分析在未來。 ## 搜索首選項 [搜索首選項](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/search-request-preference.html) _only_node已刪除。使用_only_nodes并指定單個節點ID可以實現相同的行為。 [搜索首選項](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/search-request-preference.html)?_prefer_node已被_prefer_nodes替代。通過指定單個節點，_prefer_nodes提供與_prefer_node相同的功能，但也支持指定多個節點。 [搜索首選項](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/search-request-preference.html)?_shards接受輔助首選項，例如_primary用于指定指定分片的主副本。之前用于將參數的_shards部分與輔助首選項分隔開的分隔符為。但是，這也是查詢字符串參數之間可接受的分隔符，這意味著除非; 逃避，從未觀察到次要偏好。該分隔符已更改為| 并且不需要轉義。 ## 默認相似性默認相似性已更改為BM25。 ## 解釋API fields字段已重命名為stored_fields