# Count API 原文鏈接 :?[https://www.elastic.co/guide/en/elasticsearch/reference/current/search-count.html](https://www.elastic.co/guide/en/elasticsearch/reference/current/search-count.html) 譯文鏈接 :?[http://apache.wiki/display/Elasticsearch/Count+API](http://apache.wiki/display/Elasticsearch/Count+API) 貢獻者 : @琴劍藍天 **Count API** 允許輕松執行查詢并獲取該查詢的匹配數。 它可以跨一個或多個索引并跨越一個或多個類型執行。 可以使用簡單的查詢字符串作為參數或使用在請求正文中定義的 **Query DSL** 來提供查詢。 這里是一個例子： ``` PUT /twitter/tweet/1?refresh { "user": "kimchy" } GET /twitter/tweet/_count?q=user:kimchy GET /twitter/tweet/_count { "query" : { "term" : { "user" : "kimchy" } } } ``` 注意 在正文中發送的查詢必須嵌套在查詢鍵中，與 **Search API** 相同 上面的兩個例子都做同樣的事情，這是從某個用戶的 twitter 索引計數 tweets 的數量。 其結果是： ``` { "count" : 1, "_shards" : { "total" : 5, "successful" : 5, "failed" : 0 } } ``` 查詢是可選的，如果沒有提供，它將使用 **match_all** 來計算所有的文檔。 ### Multi index, Multi type （多索引，多類型） **count API** 可以應用于多個索引中的多個類型。 ### Request Parameters （請求參數） 當使用查詢參數q執行計數時，傳遞的查詢是使用Lucene查詢解析器的查詢字符串。 還有其他可以傳遞的參數： | Name | Description | | --- | --- | | _`df`_ | 在查詢中未定義字段前綴時使用的默認字段。 | | _`analyzer`_ | 分析查詢字符串時使用的分析器名稱。 | | _`default_operator`_ | 要使用的默認運算符，可以是 **AND** 或 **OR**。 默認為 **OR**。 | | _`lenient`_ | 如果設置為 **true** 將導致基于格式的失敗（例如向數字字段提供文本）被忽略。 默認為 **false**。 | | _`lowercase_expanded_terms`_ | 術語是否自動小寫，默認為 **true** 。 | | _`analyze_wildcard`_ | 是否分析通配符和前綴查詢。 默認為false。 | | _`terminate_after`_ | 每個分片的最大計數，到達時，查詢執行將提前終止。 如果設置，響應將具有布爾字段 **terminated_early** 以指示查詢執行是否實際已終止。 默認為無 **terminate_after**。 | ### Request Body （請求主體） 計數可以使用其身體內的 **Query DSL** 來表達應該執行的查詢。 主體內容也可以作為名為 **source** 的 **REST** 參數傳遞。 **HTTP GET** 和 **HTTP POST** 都可以用于以主體執行計數。 由于并不是所有的客戶端都支持帶主體的 **GET**，因此也允許 **POST**。 ### Distributed （分布式） 計數操作在所有分片上廣播。 每個 **shard id group** 選擇一個副本并對其執行。 這意味著副本增加了計數的可伸縮性。 ### Routing （路由） 可以指定路由值（路由值的逗號分隔列表），以控制將對哪些分片執行計數請求。