#空搜索 最基本的搜索API表單是**空搜索(empty search)**，它沒有指定任何的查詢條件，只返回集群索引中的所有文檔： ```Javascript GET /_search ``` 響應內容（為了編輯簡潔）類似于這樣： ```Javascript { "hits" : { "total" : 14, "hits" : [ { "_index": "us", "_type": "tweet", "_id": "7", "_score": 1, "_source": { "date": "2014-09-17", "name": "John Smith", "tweet": "The Query DSL is really powerful and flexible", "user_id": 2 } }, ... 9 RESULTS REMOVED ... ], "max_score" : 1 }, "took" : 4, "_shards" : { "failed" : 0, "successful" : 10, "total" : 10 }, "timed_out" : false } ``` ## `hits` 響應中最重要的部分是`hits`，它包含了`total`字段來表示匹配到的文檔總數，`hits`數組還包含了匹配到的前10條數據。 `hits`數組中的每個結果都包含`_index`、`_type`和文檔的`_id`字段，被加入到`_source`字段中這意味著在搜索結果中我們將可以直接使用全部文檔。這不像其他搜索引擎只返回文檔ID，需要你單獨去獲取文檔。 每個節點都有一個`_score`字段，這是**相關性得分(relevance score)**，它衡量了文檔與查詢的匹配程度。默認的，返回的結果中關聯性最大的文檔排在首位；這意味著，它是按照`_score`降序排列的。這種情況下，我們沒有指定任何查詢，所以所有文檔的相關性是一樣的，因此所有結果的`_score`都是取得一個中間值`1` `max_score`指的是所有文檔匹配查詢中`_score`的最大值。 ## `took` `took`告訴我們整個搜索請求花費的毫秒數。 ## `shards` `_shards`節點告訴我們參與查詢的分片數（`total`字段），有多少是成功的（`successful`字段），有多少的是失敗的（`failed`字段）。通常我們不希望分片失敗，不過這個有可能發生。如果我們遭受一些重大的故障導致主分片和復制分片都故障，那這個分片的數據將無法響應給搜索請求。這種情況下，Elasticsearch將報告分片`failed`，但仍將繼續返回剩余分片上的結果。 ## `timeout` `time_out`值告訴我們查詢超時與否。一般的，搜索請求不會超時。如果響應速度比完整的結果更重要，你可以定義`timeout`參數為`10`或者`10ms`（10毫秒），或者`1s`（1秒） ```javascript GET /_search?timeout=10ms ``` Elasticsearch將返回在請求超時前收集到的結果。 超時不是一個斷路器（circuit breaker）（譯者注：關于斷路器的理解請看警告）。 > ## 警告 > 需要注意的是`timeout`不會停止執行查詢，它僅僅告訴你**目前**順利返回結果的節點然后關閉連接。在后臺，其他分片可能依舊執行查詢，盡管結果已經被發送。 > 使用超時是因為對于你的業務需求（譯者注：SLA，Service-Level Agreement服務等級協議，在此我翻譯為業務需求）來說非常重要，而不是因為你想中斷執行長時間運行的查詢。