搜索API

现在让我们开始一些简单的搜索, 有2中基础的方式执行搜索: 一种是通过REST请求URI发送查询参数, 另一种通过REST请求体. 请求体方式让你的查询更有表现力, 并且可读性更强. 接下来, 我们会用一个例子来演示如何使用请求参数. 但是本教程的余下所有部分, 我们都会使用请求体方式.

查询的REST API通过_search端点暴露给用户. 这个例子返回bank索引吓得所有文档:

GET /bank/_search?q=*&sort=account_number:asc&pretty

首先, 我们仔细分析一下搜索调用. 我们在bank索引中搜索(_search端点), 并且使用了q=*参数让Elasticsearch查询所有索引中符合条件的文档. sort=account_number:asc参数表名用account__number字段对查询结果进行排序, pretty参数告诉Elasticsearch对返回的结果美化.

响应如下(仅展示部分):

{
  "took" : 63,
  "timed_out" : false,
  "_shards" : {
    "total" : 5,
    "successful" : 5,
    "skipped" : 0,
    "failed" : 0
  },
  "hits" : {
    "total" : 1000,
    "max_score" : null,
    "hits" : [ {
      "_index" : "bank",
      "_type" : "_doc",
      "_id" : "0",
      "sort": [0],
      "_score" : null,
      "_source" : {"account_number":0,"balance":16623,"firstname":"Bradshaw","lastname":"Mckenzie","age":29,"gender":"F","address":"244 Columbus Place","employer":"Euron","email":"[email protected]","city":"Hobucken","state":"CO"}
    }, {
      "_index" : "bank",
      "_type" : "_doc",
      "_id" : "1",
      "sort": [1],
      "_score" : null,
      "_source" : {"account_number":1,"balance":39225,"firstname":"Amber","lastname":"Duke","age":32,"gender":"M","address":"880 Holmes Lane","employer":"Pyrami","email":"[email protected]","city":"Brogan","state":"IL"}
    }, ...
    ]
  }
}

对于响应, 我们可以看到以下部分:

• took - Elasticsearch执行搜索消耗的毫秒数
• timed_out - 是否超时
• _shards - 告诉我们搜索了多少个分片, 包括成功/失败的
• hits - 搜索结果
• hits.total - 符合条件的文档数量
• hits.hits - 查询结果的实际数组(默认前10个文档)
• hits.sort - 排序字段(如果根据score排序则没有)
• hits._score 和 max_score - 现在忽略这些字段

下面是同样的查询使用请求体方式:

GET /bank/_search
{
  "query": { "match_all": {} },
  "sort": [
    { "account_number": "asc" }
  ]
}

不同的是, 我们用一个JSON格式的请求体替代了q=*这个请求参数. 我们下一届会谈论这个JSON查询.

有一点非常重要, 就是一旦你得到了查询结果. Elasticsearch完全是再请求中完成的, 他不会维护任何服务端的字段, 也不会在你的结果中打开游标. 我就与其他像SQL这样的平台有了鲜明的对比, 你可能会获得查询的子集, 如果你想继续获得其余数据那么你需要不断的从服务端获取.