# Request Body Search（使用請求體進行搜索） 搜索請求能夠通過DSL來執行，在請求體中包含這個[查詢DSL](../Query_DSL.md)即可。下面是一個示例： ``` GET /twitter/tweet/_search { "query" : { "term" : { "user" : "kimchy" } } } ``` 這是一個示例的響應: ``` { "took": 1, "timed_out": false, "_shards":{ "total" : 1, "successful" : 1, "failed" : 0 }, "hits":{ "total" : 1, "max_score": 1.3862944, "hits" : [ { "_index" : "twitter", "_type" : "tweet", "_id" : "0", "_score": 1.3862944, "_source" : { "user" : "kimchy", "message": "trying out Elasticsearch", "date" : "2009-11-15T14:12:12", "likes" : 0 } } ] } } ``` ## 參數 `timeout`搜索超時，限制在指定時間值內執行的搜索請求，并在到期時收集的命中文檔。默認為無超時。請參閱[時間單位](../API_Conventions/Common_options.md#time-units)一節。 * `from`從某個偏移量中檢索匹配。默認為0。 * `size`要返回的命中數。默認為`10.`如果您不關心獲取到的一些返回內容，但僅關注匹配或聚合的數量，將值設置為`0`將有助于提高性能。 * `search_type`要執行的搜索操作的類型。可以是`dfs_query_then_fetch`或`query_then_fetch`。默認為`query_then_fetch`。查看*搜索類型*了解更多。 * `request_cache`設置為`true`或`false`以啟用或禁用在搜索請求`size`為`0`時的結果緩存，即聚合和建議（不返回頂部`hits`內容）。請參閱[Shard請求緩存](../Modules/Indices/Shard_request_cache.md)。`terminate_after`每個分片收集的最大文檔數量，達到后查詢執行將提前終止。如果設置，響應將有一個布爾字段`terminate_early`來指示查詢執行是否實際已終止。默認為`terminate_after`。 * `batched_reduce_size`分片結果的數量應該在協調節點上一次性減少。如果請求中潛在的分片數量可能較大，則該值應用作保護機制，以減少每個搜索請求的內存開銷。在上述中，`search_type`和`request_cache`必須作為查詢字符串參數傳遞。搜索請求的其余部分應在主體本身內傳遞。請求體內容也可以作為名為`source`的REST參數傳遞。 `HTTP GET`和`HTTP POST`都可以用來執行與`body`的搜索。由于并非所有客戶端都支持`GET`，所以`POST`也是允許的。 ## 速檢查任何匹配的文檔 如果我們只想知道是否有匹配特定查詢的文檔，我們可以將大小設置為`0`，表示我們對搜索結果不感興趣。此外，我們可以將`terminate_after`設置為`1`，以指示每當找到第一個匹配文檔（每個分片）時，查詢執行可以被終止。 ``` GET /_search?q=message:elasticsearch&size=0&terminate_after=1 ``` 響應不會包含大小設置為`0`的任何采樣。`hits.total`等于`0`表示沒有匹配的文檔，或大于`0`表示至少有與查詢匹配的數量的文檔（當它被提前終止時）。此外，如果查詢提前終止，則在響應中將`terminate_early`標志設置為`true`。 ``` { "took": 3, "timed_out": false, "terminated_early": true, "_shards": { "total": 1, "successful": 1, "failed": 0 }, "hits": { "total": 1, "max_score": 0.0, "hits": [] } } ```