Elasticsearch的timeout机制与_search结果字段释义

一、_search结果

1、ES语句

GET /product/_search

2、结果

{
  "took" : 1,
  "timed_out" : false,
  "_shards" : {
    "total" : 1,
    "successful" : 1,
    "skipped" : 0,
    "failed" : 0
  },
  "hits" : {
    "total" : {
      "value" : 3,
    },
    "max_score" : 1.0,
    "hits" : [
      {
        "_index" : "product",
        "_type" : "_doc",
        "_id" : "1",
        "_score" : 1.0,
        "_source" : {
          "name" : "xiaomi shouji",
          "desc" : "niubi quanwangtong"
        }
      }
    ]
  }
}

3、结果分析

字段	解释
took	此次搜索请求消费了多少时间（ms）
timed_out	搜索超时时间，具体含义下面说
_shards.total	shard的总个数
_shards.successful	shard的成功数，
_shards.failed	坏掉的shard个数。primary 和 replica全部挂掉才会产生failed数，代表这个shard的index完全不可用。
hits.total.value	此次搜索请求返回了多少条document
hits.max_score	此次搜索的所有结果中，最大的相关度分数是多少
hits.hits	此次请求返回的document，默认前10条。按照相关度_score降序排序

二、timeout机制

1、用法

GET /search?timeout=1s/ms/m

2、demo

GET /_search?timeout=10ms
GET /test_index/_search?timeout=10s
GET /product/_search?timeout=10m

3、详细说明

• 默认查询都没设置timeout
• 若设置了则规则是如下

假设用户查询结果有10W条数据，但是需要10分钟才能查询完毕，但是用户设置了1秒的timeout，那么不管当前1s内一共查询到了多少数据，都会返回这1s内的的数据，也就是说查询超过1s了，ES会自动在1s的时候结束查询，将当前的查询结果返回给client。

4、总结

• timeout机制可以防止N个请求进来阻塞在那里
• timeout导致搜索的数据可能不是全的，也可能是全的