搜索API


该API用于在 ElasticSearch中搜索内容。用户可以通过发送以查询字符串作为参数的get请求进行搜索,也可以在post请求的消息体中进行查询。所有的搜索APIS都支持多索引、多类型的(新版本的ES已经弱化了类型的概念,一个索引只支持一个类型)。

多索引

ElasticSearch允许我们搜索所有索引或某些特定索引中的文档。例如,如果我们需要搜索所有name包含central的文档。

GET  /_search?q = name:central

响应

{
   "took":78, "timed_out":false, "_shards":{"total":10, "successful":10, "failed":0},
   "hits":{
      "total":1, "max_score":0.19178301, "hits":[{
         "_index":"schools", "_type":"school", "_id":"1", "_score":0.19178301,
         "_source":{
            "name":"Central School", "description":"CBSE Affiliation", 
            "street":"Nagan", "city":"paprola", "state":"HP", "zip":"176115",
            "location":[31.8955385, 76.8380405], "fees":2000, 
            "tags":["Senior Secondary", "beautiful campus"], "rating":"3.5"
         }
      }]
   }
}

或者,我们可以在schools、schools_gov索引中搜索相同的内容

GET /schools,schools_gov/_search?q = name:model

多类型

注意:新版本的ES已经弱化了类型的概念,一个索引只支持一个类型。

GET /schools/_search?q = tags:sports

响应

{
   "took":16, "timed_out":false, "_shards":{"total":5, "successful":5, "failed":0},
   "hits":{
      "total":1, "max_score":0.5, "hits":[{
         "_index":"schools", "_type":"school", "_id":"2", "_score":0.5,
         "_source":{
            "name":"Saint Paul School", "description":"ICSE Afiliation", 
            "street":"Dawarka", "city":"Delhi", "state":"Delhi", "zip":"110075", 
            "location":[28.5733056, 77.0122136], "fees":5000, 
            "tags":["Good Faculty", "Great Sports"], "rating":"4.5"
         }
      }]
   }
}

URI搜索

我们可以在URI中传递许多参数

  • Q:用于指定搜索的字符串
  • lenient:若将此参数设置为true,就可以忽略基于格式的错误。默认情况下,它为false。
  • fields:该参数帮助我们从选择性字段中获得响应。
  • sort:我们可以通过使用这个参数改变排序结果,这个参数允许的值是字段名:ASC/字段名:desc
  • timeout:我们可以通过使用该参数来限制搜索时间,并且响应仅包含在指定时间内的命中。默认情况下,不指定timeout。
  • terminate_after:对于每个分片,我们可以将响应限制在指定数量的文档,一旦达到这个数量,查询将提前终止。默认情况下,不指定terminate_after。
  • from:从指定的索引开始返回. 默认为0.
  • size:表示要返回的记录数. 默认为10.

请求体查询

我们也可以在请求体中使用DSL来指定查询条件,在前面的章节中已经给出了许多例子,例如:

POST /schools/_search
{
   "query":{
      "query_string":{
         "query":"up"
      }
   }
}

响应

……………………………………………….
{
   "_source":{
      "name":"City School", "description":"ICSE", "street":"West End",
      "city":"Meerut", "state":"UP", "zip":"250002", "location":[28.9926174, 77.692485],
      "fees":3500, "tags":["Well equipped labs"],"rating":"4.5"
   }
}
……………………………………………….

results matching ""

    No results matching ""