The Search API（搜索 API） · Elasticsearch 5.4 中文文檔

# The Search API（搜索 API）原文鏈接 : [https://www.elastic.co/guide/en/elasticsearch/reference/5.4/_the_search_api.html](https://www.elastic.co/guide/en/elasticsearch/reference/5.4/_the_search_api.html) 譯文鏈接 : [http://www.apache.wiki/pages/viewpage.action?pageId=4260748](http://www.apache.wiki/pages/viewpage.action?pageId=4260748) 貢獻者 : [那伊抹微笑](/display/~wangyangting)，[ApacheCN](/display/~apachecn)，[Apache中文網](/display/~apachechina) 現在讓我們從一些簡單的搜索開始。這里兩個運行搜索的基本方法 : 一個是通過使用 [REST request URI](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/search-uri-request.html "URI Search")??發送搜索參數，另一個是通過使用 ?[REST request body](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/search-request-body.html "Request Body Search")?來發送它們。請求體的方法可以讓您更具有表現力，并且可以在一個更可讀的 **JSON** 格式中定義您的搜索。我們會嘗試使用一個?[REST request URI](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/search-uri-request.html "URI Search")?的示例，但是在本教程的其它部分，我們將只使用 [REST request body](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/search-request-body.html "Request Body Search")?的方法。搜索的 **REST API** 從 **_search** 的尾部開始。這個示例返回了 **bank** 索引中的所有文檔 :? ``` curl -XGET 'localhost:9200/bank/_search?q=*&sort=account_number:asc&pretty' ``` 首先讓我們切開搜索的調用。我們在 **bank** 索引中執行搜索（**_search** 尾部），然后 **q=*** 參數命令 **Elasticsearch** 去匹配索引中所有的文檔。**pretty** 參數，再一次告訴 **Elasticsearch** 去返回打印漂亮的 **JSON** 結果。響應如下（部分）:? ``` { "took" : 63, "timed_out" : false, "_shards" : { "total" : 5, "successful" : 5, "failed" : 0 }, "hits" : { "total" : 1000, "max_score" : null, "hits" : [ { "_index" : "bank", "_type" : "account", "_id" : "0", "sort": [0], "_score" : null, "_source" : {"account_number":0,"balance":16623,"firstname":"Bradshaw","lastname":"Mckenzie","age":29,"gender":"F","address":"244 Columbus Place","employer":"Euron","email":"bradshawmckenzie@euron.com","city":"Hobucken","state":"CO"} }, { "_index" : "bank", "_type" : "account", "_id" : "1", "sort": [1], "_score" : null, "_source" : {"account_number":1,"balance":39225,"firstname":"Amber","lastname":"Duke","age":32,"gender":"M","address":"880 Holmes Lane","employer":"Pyrami","email":"amberduke@pyrami.com","city":"Brogan","state":"IL"} }, ... ] } } ``` 在響應中，我們可以看到以下幾個部分 :? * **took** - **Elasticsearch** 執行搜索的時間（毫秒） * **time_out** - 告訴我們搜索是否超時 * **_shards** - 告訴我們多少個分片被搜索了，以及統計了成功/失敗的搜索分片 * **hits** - 搜索結果 * **hits.total** - 搜索結果 * **hits.hits** - 實際的搜索結果數組（默認為前 **10** 的文檔） * **sort** - 結果的排序 **key**（鍵）（沒有則按 **score** 排序） * _**score**_ 和**max_score** -現在暫時忽略這些字段這里是上面相同的搜索，使用了?[REST request body](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/search-request-body.html "Request Body Search")?方法 :? ``` curl -XGET 'localhost:9200/bank/_search?pretty' -d' { "query": { "match_all": {} }, "sort": [ { "account_number": "asc" } ] }' ``` 這里不同的地方是而不是在 **URL** 中傳遞 **q=*** ，我們 **POST** 一個 **JSON** 風格的查詢請求體到 **_search** **API**。我們將在下一部分討論這個 **JSON** 查詢。需要了解，一旦您搜索的結果被返回，**Elasticsearch** 完成了這次請求，并且不會維護任何服務端的資源或者結果的 **cursor**（游標）。這與其它的平臺形成了鮮明的對比，例如 **SQL**，您可能首先獲得查詢結果的子集，如果您想要使用一些服務端有狀態的 **cursor**（光標）來抓取（或者通過分頁）其它的結果，然后您必須再次回到服務器。