elasticsearch系列四：搜索详解（搜索API、Query DSL）

一、搜索 API

1. 搜索 API 端点地址

从索引 tweet 里面搜索字段 user 为 kimchy 的记录

GET /twitter/_search?q=user:kimchy

从索引 tweet,user 里面搜索字段 user 为 kimchy 的记录

GET /twitter/tweet,user/_search?q=user:kimchy

GET /kimchy,elasticsearch/_search?q=tag:wow

从所有索引里面搜索字段 tag 为 wow 的记录

GET /_all/_search?q=tag:wow
GET /_search?q=tag:wow

说明：搜索的端点地址可以是多索引多 mapping type 的。搜索的参数可作为 URI 请求参数给出，也可用 request body 给出

2. URI Search

URI 搜索方式通过 URI 参数来指定查询相关参数。让我们可以快速做一个查询。

GET /twitter/_search?q=user:kimchy

可用的参数请参考： https://www.elastic.co/guide/en/elasticsearch/reference/current/search-uri-request.html

3. 查询结果说明

5. 特殊的查询参数用法

如果我们只想知道有多少文档匹配某个查询，可以这样用参数：

GET /bank/_search?q=city:b*&size=0

如果我们只想知道有没有文档匹配某个查询，可以这样用参数：

GET /bank/_search?q=city:b*&size=0&terminate_after=1

比较两个查询的结果可以知道第一个查询返回所有的命中文档数，第二个查询由于只需要知道有没有文档，所以只要有文档就立即返回

 6. Request body Search

Request body 搜索方式以 JSON 格式在请求体中定义查询 query。请求方式可以是 GET 、POST 。

GET /twitter/_search
{
    "query" : {
        "term" : { "user" : "kimchy" }
    }
}

可用的参数:

timeout：请求超时时长，限定在指定时长内响应（即使没查完）；
from： 分页的起始行，默认 0；
size：分页大小；
request_cache：是否缓存请求结果，默认 true。
terminate_after：限定每个分片取几个文档。如果设置，则响应将有一个布尔型字段 terminated_early 来指示查询执行是否实际已经 terminate_early。缺省为 no terminate_after；
search_type：查询的执行方式，可选值 dfs_query_then_fetch or query_then_fetch ，默认： query_then_fetch ；
batched_reduce_size：一次在协调节点上应该减少的分片结果的数量。如果请求中的潜在分片数量可能很大，则应将此值用作保护机制以减少每个搜索请求的内存开销。

6.1 query 元素定义查询

query 元素用 Query DSL 来定义查询。

GET /_search
{
    "query" : {
        "term" : { "user" : "kimchy" }
    }
}

6.2 指定返回哪些内容

6.2.1 source filter  对 _source 字段进行选择

GET /_search
{
    "_source": false,
    "query" : {
        "term" : { "user" : "kimchy" }
    }
}