RESTful Api

在ES中，提供了功能丰富的restful api 的操作，包括基本的CURD、创建索引、删除索引等操作。

        创建非结构化索引

在lucene中 ，创建索引是需要定义字段名称以及字段的类型的，在ES中提供了非结构化的索引，就是不需要创建索引结构，即可写入数据到索引中，实际上ES底层会进行结构化操作，此操作对用户是透明的。

#创建索引 http://127.0.0.1:9200/contentPUT /content{"settings":{"index":{"number_of_shards":"2",  //#分片数"number_of_replicas":"0" //#副本数}}
}#删除索引 http://127.0.0.1:9200/content
DELETE  /content

        插入数据

URL规则：
POST /索引/类型/{id}POST    http://127.0.0.1:9200/content/user/100{"id":100,"name":"张三","age":18,"sex":"男"
}

说明：非结构化的索引，不需要时限创建，直接插入数据默认创建索引。

不指定ID插入数据 ， ES字段创建32位字符串长度id

URL规则：
POST /索引/类型/POST    http://127.0.0.1:9200/content/user/{"id":100,"name":"张三","age":18,"sex":"男"
}

        更新数据

在ES中，文档数据是不为修改的，但是可以通过覆盖的方式进行更新。

PUT    http://127.0.0.1:9200/content/user/100{"id":100,"name":"张三","age":18,"sex":"未知"
}

                局部字段更新

#注意：这里多了 _update 标识
POST    http://127.0.0.1:9200/content/user/100/_update#多一层 doc
{"doc":{"age":15}
}

        删除数据 （如果删除不存在的数据 状态码404）

_idDELETE    http://127.0.0.1:9200/content/user/100

        搜索数据

GET    http://127.0.0.1:9200/content/user/100#返回数据{"_index": "content","_type": "user","_id": "100","_version": 3,"found": true,"_source": {"id": 100,"name": "张三","age": 15,"sex": "未知"}
}

查询全部数据，响应（默认返回10条数据）

_searchGET    http://127.0.0.1:9200/content/user/_search返回数据：
{"took": 72,"timed_out": false,"_shards": {"total": 2,"successful": 2,"failed": 0},"hits": {"total": 2,"max_score": 1.0,"hits": [{"_index": "content","_type": "user","_id": "AXzQGuVL9AvrP5Vp8NAL","_score": 1.0,"_source": {"id": 101,"name": "李三","age": 20,"sex": "男"}},{"_index": "content","_type": "user","_id": "100","_score": 1.0,"_source": {"id": 100,"name": "张三","age": 15,"sex": "未知"}}]}
}

 关键字查询数据

_search
# 查询年龄等于20GET    http://127.0.0.1:9200/content/user/_search?q=age:20返回数据：
{"took": 62,"timed_out": false,"_shards": {"total": 2,"successful": 2,"failed": 0},"hits": {"total": 1,"max_score": 1.0,"hits": [{"_index": "content","_type": "user","_id": "AXzQGuVL9AvrP5Vp8NAL","_score": 1.0,"_source": {"id": 101,"name": "李三","age": 20,"sex": "男"}}]}
}

        DSL搜索

ES提供丰富且灵活的查询语音叫做DSL查询（QUERY DSL）允许你构建更加复杂、强大的查询，以Json请求形式出现

_search
# 查询年龄等于20POST   http://127.0.0.1:9200/content/user/_search请求数据：
{"query":{"match":{"age":20}}
}返回数据：
{"took": 64,"timed_out": false,"_shards": {"total": 2,"successful": 2,"failed": 0},"hits": {"total": 1,"max_score": 1.0,"hits": [{"_index": "content","_type": "user","_id": "AXzQGuVL9AvrP5Vp8NAL","_score": 1.0,"_source": {"id": 101,"name": "李三","age": 20,"sex": "男"}}]}
}

_search
# 查询条件：  age > 20 && sex ="男"POST   http://127.0.0.1:9200/content/user/_search请求数据：
{"query":{"bool":{"filter":{"range":{"age":{"gt":15}}},"must":{"match":{"sex":"男"}}}}
}返回数据：
{"took": 26,"timed_out": false,"_shards": {"total": 2,"successful": 2,"failed": 0},"hits": {"total": 1,"max_score": 1.0,"hits": [{"_index": "content","_type": "user","_id": "AXzQGuVL9AvrP5Vp8NAL","_score": 1.0,"_source": {"id": 101,"name": "李三","age": 20,"sex": "男"}}]}
}

 

_search
# 查询条件：  name  "李三 张三"POST   http://127.0.0.1:9200/content/user/_search请求数据：
{"query":{"match":{"name":"李三 张三"}}
}返回数据：
{"took": 41,"timed_out": false,"_shards": {"total": 2,"successful": 2,"failed": 0},"hits": {"total": 2,"max_score": 0.48631853,"hits": [{"_index": "content","_type": "user","_id": "AXzQGuVL9AvrP5Vp8NAL","_score": 0.48631853,"_source": {"id": 101,"name": "李三","age": 20,"sex": "男"}},{"_index": "content","_type": "user","_id": "100","_score": 0.48631853,"_source": {"id": 100,"name": "张三","age": 15,"sex": "未知"}}]}
}

        高亮显示  highilght

_search
# 查询条件：  name  "李三 张三"POST   http://127.0.0.1:9200/content/user/_search请求数据：
{"query":{"match":{"name":"李三 张三"}},"highlight":{"fields":{"name":{}}}
}返回数据：
{"took": 46,"timed_out": false,"_shards": {"total": 2,"successful": 2,"failed": 0},"hits": {"total": 2,"max_score": 0.48631853,"hits": [{"_index": "content","_type": "user","_id": "AXzQGuVL9AvrP5Vp8NAL","_score": 0.48631853,"_source": {"id": 101,"name": "李三","age": 20,"sex": "男"},"highlight": {"name": ["<em>李</em><em>三</em>"]}},{"_index": "content","_type": "user","_id": "100","_score": 0.48631853,"_source": {"id": 100,"name": "张三","age": 15,"sex": "未知"},"highlight": {"name": ["<em>张</em><em>三</em>"]}}]}
}

        聚合

在ES中，支持聚合操作，类似SQL中的 group by

_search
# 聚合： agePOST   http://127.0.0.1:9200/content/user/_search请求数据：
{"aggs":{"all_interests":{"terms":{"field" :"age"}}}
}返回数据：
{"took": 62,"timed_out": false,"_shards": {"total": 2,"successful": 2,"failed": 0},"hits": {"total": 5,"max_score": 1.0,"hits": [{"_index": "content","_type": "user","_id": "AXzQGuVL9AvrP5Vp8NAL","_score": 1.0,"_source": {"id": 101,"name": "李三","age": 20,"sex": "男"}},{"_index": "content","_type": "user","_id": "100","_score": 1.0,"_source": {"id": 100,"name": "张三","age": 15,"sex": "未知"}},{"_index": "content","_type": "user","_id": "AXzQPW829AvrP5Vp8NAN","_score": 1.0,"_source": {"id": 101,"name": "李三","age": 20,"sex": "男"}},{"_index": "content","_type": "user","_id": "AXzQPY279AvrP5Vp8NAO","_score": 1.0,"_source": {"id": 103,"name": "李三","age": 20,"sex": "男"}},{"_index": "content","_type": "user","_id": "AXzQPZ0T9AvrP5Vp8NAP","_score": 1.0,"_source": {"id": 104,"name": "李三","age": 20,"sex": "男"}}]},"aggregations": {"all_interests": {"doc_count_error_upper_bound": 0,"sum_other_doc_count": 0,"buckets": [{"key": 20,"doc_count": 4},{"key": 15,"doc_count": 1}]}}
}

核心详解

        文档

        查询响应

                pretty        

                指定响应字段

        判断是否存在

        批量操作