Multi Search API · Elasticsearch 5.4 中文文檔

# Multi Search API 原文鏈接 :?[https://www.elastic.co/guide/en/elasticsearch/reference/current/search-multi-search.html](https://www.elastic.co/guide/en/elasticsearch/reference/current/search-multi-search.html) 譯文鏈接 : [http://apache.wiki/display/Elasticsearch/Multi+Search+API](http://apache.wiki/display/Elasticsearch/Multi+Search+API) 貢獻者 : @琴劍藍天 **multi search API?**允許在同一API中執行多個搜索請求。它的端點（**endpoint**）是** `_msearch`** 。它的請求格式與 **multi API** 相似，結構如下（如果特定搜索最終重定向到另一個節點，則結構被特別優化以減少解析）： ``` header\n body\n header\n body\n ``` **header** 分包括要搜索的 **index / indices ，可搜索的可選（mapping）types** ，**search_type**，** `preference`** 和 **`routing`。** 正文包括典型的搜索正文請求（包括**`query`, `aggregations`, `from`, `size`** 等）。這里是一個例子： ``` $ cat requests {"index" : "test"} {"query" : {"match_all" : {}}, "from" : 0, "size" : 10} {"index" : "test", "search_type" : "dfs_query_then_fetch"} {"query" : {"match_all" : {}}} {} {"query" : {"match_all" : {}}} {"query" : {"match_all" : {}}} {"search_type" : "dfs_query_then_fetch"} {"query" : {"match_all" : {}}} $ curl -XGET localhost:9200/_msearch --data-binary "@requests"; echo ``` 注意，上面包括也被支持的空標題（也可以只是沒有任何內容）的示例。該響應返回一個響應數組，其中包括每個搜索請求的搜索響應和狀態代碼，與其在原始 **multi search** 請求中的順序相匹配。如果該特定搜索請求的完全失敗，將返回具有錯誤消息和相應狀態代碼的對象，而不是實際的搜索響應。端點還允許對URI中的 **index/indices**和 **type/types** 進行搜索，在這種情況下，它將被用作默認值，除非在標題中另有明確定義。例如： ``` $ cat requests {} {"query" : {"match_all" : {}}, "from" : 0, "size" : 10} {} {"query" : {"match_all" : {}}} {"index" : "test2"} {"query" : {"match_all" : {}}} $ curl -XGET localhost:9200/test/_msearch --data-binary @requests; echo ``` 上面將針對沒有定義索引的所有請求對 **test** 索引執行搜索，最后一個將針對 **test2** 索引執行。可以以類似的方式設置 **search_type** 以全局地應用于所有搜索請求。 **msearch** 的 _**max_concurrent_searches**_ 請求參數可用于控制 **multi search api** 將執行的并發搜索的最大數量。此默認值基于數據節點的數量和默認搜索線程池大小。 ### 安全請查看?[](https://www.elastic.co/guide/en/elasticsearch/reference/current/url-access-control.html "URL-based access control")_[_URL-based access control_](https://www.elastic.co/guide/en/elasticsearch/reference/current/url-access-control.html)_