004 API约定

　　在具体的学习前，我还是决定学一下，REST风格中在ES中的约定。

一：索引

1.多重索引

　　先准备数据：

　　　　如果不小心，json里的值写错了，修改过来，重新执行即可。

 PUT index1/_doc/1
 {
   "name":"tom1"
 }
 PUT index2/_doc/1
 {
   "name":"tom1",
   "age":20
 }
 PUT index3/_doc/1
 {
   "name":"tom3",
   "address":"tom3 is good ,in beijing"
 }

　　多重索引：

  POST /index1,index2,index3/_search
  {
    "query":{
      "query_string": {
        "query":"tom1"
      }
    }
  }

　　结果：

　　　　返回index1,index2,index3中包含tom1的Json对象，如果只输入tom，则是查询不到值的。

 {
   "took" : 2,
   "timed_out" : false,
   "_shards" : {
     "total" : 3,
     "successful" : 3,
     "skipped" : 0,
     "failed" : 0
   },
   "hits" : {
     "total" : {
       "value" : 2,
       "relation" : "eq"
     },
     "max_score" : 0.6931472,
     "hits" : [
       {
         "_index" : "index2",
         "_type" : "_doc",
         "_id" : "1",
         "_score" : 0.6931472,
         "_source" : {
           "name" : "tom1",
           "age" : 20
         }
       },
       {
         "_index" : "index1",
         "_type" : "_doc",
         "_id" : "1",
         "_score" : 0.2876821,
         "_source" : {
           "name" : "tom1"
         }
       }
     ]
   }
 }

2._all关键字

　　所有的索引

  POST _all/_search
  {
    "query":{
      "query_string": {
        "query":"tom3"
      }
    }
  }

　　效果：

 {
   "took" : 19,
   "timed_out" : false,
   "_shards" : {
     "total" : 6,
     "successful" : 6,
     "skipped" : 0,
     "failed" : 0
   },
   "hits" : {
     "total" : {
       "value" : 1,
       "relation" : "eq"
     },
     "max_score" : 0.2876821,
     "hits" : [
       {
         "_index" : "index3",
         "_type" : "_doc",
         "_id" : "1",
         "_score" : 0.2876821,
         "_source" : {
           "name" : "tom3",
           "address" : "tom3 is good ,in beijing"
         }
       }
     ]
   }
 }

3.通配符的使用

　　通配符主要有：* ，+ ，-

　　*:

　　index开头的索引中查找有tom3的JSON对象。

  POST /index*/_search
  {
    "query":{
      "query_string": {
        "query":"tom3"
      }
    }
  }

　　-:

　　不包含index2的索引中查找

 POST /index*,-index2/_search
 {
   "query":{
     "query_string": {
       "query": "tom1"
     }
   }
 }

4.URL查询字符串参数

　　①ignore_unavailable:如果不存在索引，一个或者多个，都不会停止，继续运行

 POST /index1,index4/_search
 {
   "query":{
     "query_string": {
       "query": "tom1"
     }
   }
 }

　　则有问题：

 {
   "error" : {
     "root_cause" : [
       {
         "type" : "index_not_found_exception",
         "reason" : "no such index [index4]",
         "resource.type" : "index_or_alias",
         "resource.id" : "index4",
         "index_uuid" : "_na_",
         "index" : "index4"
       }
     ],
     "type" : "index_not_found_exception",
     "reason" : "no such index [index4]",
     "resource.type" : "index_or_alias",
     "resource.id" : "index4",
     "index_uuid" : "_na_",
     "index" : "index4"
   },
   "status" : 404
 }

　　加上参数：

 POST /index1,index4/_search?ignore_unavailable=true
 {
   "query":{
     "query_string": {
       "query": "tom1"
     }
   }
 }

　　效果：

 {
   "took" : 1,
   "timed_out" : false,
   "_shards" : {
     "total" : 1,
     "successful" : 1,
     "skipped" : 0,
     "failed" : 0
   },
   "hits" : {
     "total" : {
       "value" : 1,
       "relation" : "eq"
     },
     "max_score" : 0.2876821,
     "hits" : [
       {
         "_index" : "index1",
         "_type" : "_doc",
         "_id" : "1",
         "_score" : 0.2876821,
         "_source" : {
           "name" : "tom1"
         }
       }
     ]
   }
 }

　　②allow_no_indices:如果没有通配符指定的索引，true可以防止报错

 POST /mmm*/_search?allow_no_indices=true
 {
   "query":{
     "query_string": {
       "query": "tom1"
     }
   }
 }

　　效果：

 {
   "took" : 0,
   "timed_out" : false,
   "_shards" : {
     "total" : 0,
     "successful" : 0,
     "skipped" : 0,
     "failed" : 0
   },
   "hits" : {
     "total" : {
       "value" : 0,
       "relation" : "eq"
     },
     "max_score" : 0.0,
     "hits" : [ ]
   }
 }

二：响应

1.响应信息过滤

　　数据：

 {
   "took" : 2,
   "timed_out" : false,
   "_shards" : {
     "total" : 3,
     "successful" : 3,
     "skipped" : 0,
     "failed" : 0
   },
   "hits" : {
     "total" : {
       "value" : 2,
       "relation" : "eq"
     },
     "max_score" : 0.2876821,
     "hits" : [
       {
         "_index" : "index1",
         "_type" : "_doc",
         "_id" : "1",
         "_score" : 0.2876821,
         "_source" : {
           "name" : "tom1"
         }
       },
       {
         "_index" : "index2",
         "_type" : "_doc",
         "_id" : "1",
         "_score" : 0.2876821,
         "_source" : {
           "name" : "tom1",
           "age" : 20
         }
       }
     ]
   }
 }

　　过滤：

 POST /index1,index2/_search?filter_path=hits.hits._source.age
 {
   "query":{
     "query_string": {
       "query": "tom1"
     }
   }
 }

　　效果：

 {
   "hits" : {
     "hits" : [
       {
         "_source" : {
           "age" : 20
         }
       }
     ]
   }
 }

2.漂亮的结果

 Post /index1/_search?pretty=true
 {
   "query":{
     "match_all": {}
   }
 }