Search · Elasticsearch 5.4 中文文檔

# Search 原文鏈接 : [https://www.elastic.co/guide/en/elasticsearch/reference/current/search-search.html](https://www.elastic.co/guide/en/elasticsearch/reference/current/search-search.html) 譯文鏈接 : [http://www.apache.wiki/pages/editpage.action?pageId=4883051](http://www.apache.wiki/pages/editpage.action?pageId=4883051) 貢獻者 : [ping](/display/~wangyangting) **search API ?**允許你執行一個搜索查詢并返回與查詢匹配的搜索點擊。可以使用簡單的查詢字符串作為參數或使用請求主體提供查詢。 **Multi-Index, Multi-Type** 所有?**search API ?**可以應用于索引內的跨多個類型，并跨多個索引應用，支持多索引語法。例如，我們可以在 twitter 索引中搜索所有類型的所有文檔： ``` GET /twitter/_search?q=user:kimchy ``` 我們還可以在特定類型中進行搜索: ``` GET /twitter/tweet,user/_search?q=user:kimchy ``` 我們還可以在多個索引之間搜索具有某個標簽的所有 tweet（例如，當每個用戶都有自己的索引時）： ``` GET /kimchy,elasticsearch/tweet/_search?q=tag:wow ``` 或者我們可以使用_all占位符搜索所有可用索引中的所有tweet： ``` GET /_all/tweet/_search?q=tag:wow ``` 甚至搜索所有的索引和所有類型： ``` GET /_search?q=tag:wow ``` 默認情況下，elasticsearch 拒絕將查詢超過 1000 個分片的搜索請求。原因是這樣大量的分片使協調節點的工作非常耗費 CPU 和內存。使用較少的較大碎片這種方式組織數據通常是一個更好的主意。如果您想繞過此限制（不鼓勵），可以將 action.search.shard_count.limit 集群設置更新為更大的值。 ## Parameters URI 中允許使用的參數有: | Name? | Description | | --- | --- | | `q` | 查詢字符串(映射到 query_string 查詢，有關更多詳細信息，請參閱查詢字符串查詢） | | `df` | 在查詢中未定義字段前綴時使用的默認字段。 | | `analyzer` | 分析查詢字符串時使用的分析器名稱。 | | `lowercase_expanded_terms` | 應將條款自動縮小或不縮小。默認為 true。 | | `analyze_wildcard` | 應該分析通配符和前綴查詢還是不分析。默認為 false。 | | `default_operator` | 要使用的默認運算符，可以是 AND 或 OR 。默認為 OR。 | | `lenient` | 如果設置為 true 將導致基于格式的失敗（例如向數字字段提供文本）被忽略。默認為 false。 | | `explain` | 對于每個命中，包含對如何計算命中的計分的解釋。 | | `_source` | 設置為false以禁用檢索 _source 字段。您還可以使用 _source_include＆_source_exclude 檢索文檔的一部分（有關更多詳細信息，請參閱請求主體文檔）。 | | `stored_fields` | 為每次命中返回文檔的選擇性存儲字段，逗號分隔。未指定任何值將不會返回任何字段。 | | `sort` | 排序執行。可以是 fieldName 或 fieldName：asc/fieldName：desc的形式。 fieldName 可以是文檔中的實際字段，也可以是指示基于分數排序的特殊 _score 名稱。可以有幾個 sort 參數（順序很重要）。 | | `track_scores` | 排序時，設置為 true 以便仍然跟蹤分數并將其作為每次匹配的一部分返回。 | | `timeout` | 搜索超時，將搜索請求限制為在指定的時間值內執行并且保留與到期時累積的點擊數。默認為無超時。 | | `terminate_after` | 要為每個分片收集的文檔的最大數量，到達時，查詢執行將提前終止。如果設置，響應將有布爾型字段 terminated_early 以指示查詢執行是否實際已提前終止。默認為無terminate_after。 | | `from` | 從命中的索引開始返回。默認值為 0。 | | `size` | 要返回的匹配數。默認值為 10。 | | `search_type` | 要執行的搜索操作的類型。可以是 dfs_query_then_fetch 或 query_then_fetch。默認為 query_then_fetch。有關可以執行的不同類型搜索的更多詳細信息，請參閱搜索類型。 |