文档的查询相对复杂些,而且内容比较多,学会了使用 RESTful API 查询,到后边学习 Java REST Client API 时,也就简单了。
在上一篇创建的索引库基础上,我们再添加几条文档数据,来丰富可查询的内容:
PUT user/_doc/2
{
"name": "王五",
"age": 25,
"label": [
"打工人",
"宅男",
"王者荣耀"
]
}
POST user/_doc/3
{
"name": "赵六",
"age": 43,
"label": [
"脱口秀",
"直播带货",
"王者荣耀"
]
}
POST user/_doc/4
{
"name": "张三丰",
"age": 80,
"label": [
"武当山",
"太极"
]
}
POST user/_doc/5
{
"name": "王重阳",
"age": 70,
"label": [
"终南山",
"全真教"
]
}
POST user/_doc/6
{
"name": "王者荣耀",
"age": 2,
"label": [
"游戏",
"好玩"
]
}
现在一共有如下的文档数据:
1、简单的查询
准备好了数据,那就开始我们的文档查询之旅吧。
最简单的,我们可以直接根据文档 id 去查询:
GET user/_doc/1
根据 id 去查询确实不够灵活,可以在索引名后边添加_search
关键字,如下 API 会默认查出索引中的前10条数据:
GET user/_search
也可以添加查询条件,直接在路径后拼接键为q
,值为字段名:查询条件内容
格式的参数,例如查询name
是王重阳
的文档:
GET user/_search?q=name:王重阳
但是将查询条件拼接在路径后,难以构造更复杂的查询条件,我们也可以将查询条件放在请求体里,使用 JSON 格式构造复杂的查询条件,也就是Query DSL
。到这里真正的文档查询才算开始,我们从下边几个方面来看。
2、match
GET user/_search
{
"query": {
"match": {
"name": "王重阳"
}
}
}
这里我们要查询name
是王重阳
的文档,需要注意的是,match
查询时,同时使用 ES 默认的分词器,查询的关键字王重阳
会被分词为王
、重
、阳
,所以只要name
包含这三个词中一个或多个的文档都会被查询出来。所以最终王重阳
和王五
都会被查询出来。
3、 match_phrase
如果希望能够精准查询,可以使用match_phrase
,match_phrase
也会对查询的关键字分词,但是分词后的各个词必须在文档字段中都出现,并且顺序一致而且是连续的:
GET user/_search
{
"query": {
"match_phrase": {
"name": "王重阳"
}
}
}
最终只会查询出name
是王重阳
的文档。
4、term
使用term
查询时不会对查询的关键字分词,而是直接用关键字去和文档字段生成的索引去匹配:
GET user/_search
{
"query": {
"term": {
"name": "王重阳"
}
}
}
5、multi_match
如果需要查询多个字段,只要其中最少一个字段能匹配上就可以,multi_match
可以实现这个功能
GET user/_search
{
"query": {
"multi_match": {
"query": "王者荣耀",
"fields": ["name","label"]
}
}
}
注意查询的关键字同样会被分词。
6、range
range
可以按范围查询,例如查询age
>=10并且age
<=40的文档数据:
GET user/_search
{
"query": {
"range": {
"age": {
"gte": 10,
"lte": 40
}
}
}
}
-
gte
:>= -
gt
:> -
lte
:<= -
lt
:<
7、sort
sort
可以将查询出来的数据按指定字段升序(asc
)或降序(desc
)排列:
GET user/_search
{
"query": {
"range": {
"age": {
"gte": 10,
"lte": 40
}
}
},
"sort": [
{
"age": {
"order": "asc"
}
}
]
}
8、from、size
from
(默认从第0行开始)、size
(默认10条数据)可以实现分页的功能,表示从第几行开始查询几条文档数据:
GET user/_search
{
"query": {
"range": {
"age": {
"gte": 10,
"lte": 40
}
}
},
"sort": [
{
"age": {
"order": "asc"
}
}
],
"from": 0,
"size": 2
}
9、bool
bool
表示多个条件联合查询,会使用到must
、must_not
、should
、filter
,使用联合查询也可以实现multi_match
的功能。我们分别来看:
must
表示必须匹配所有条件,如下查询name
以王
开头,同时,age
>=10并且age
<=40的文档数据:
GET user/_search
{
"query": {
"bool": {
"must": [
{
"match_phrase_prefix": {
"name": "王"
}
},
{
"range": {
"age": {
"gte": 10,
"lte": 40
}
}
}
]
}
}
}
查询结果截图如下:
must_not
和must
相反,表示所有条件都不匹配,这里就不演示了。
should
表示只要其中一个条件匹配即可,如下表示查询name
以王
开头,或者,age
>=10并且age
<=40的文档数据:
GET user/_search
{
"query": {
"bool": {
"should": [
{
"match_phrase_prefix": {
"name": "王"
}
},
{
"range": {
"age": {
"gte": 10,
"lte": 40
}
}
}
]
}
}
}
filter
的功能和must
类似,过滤出匹配所有条件的文档数据,但是filter
不参与查询结果的得分(_score
)计算,性能会更好一些:
GET user/_search
{
"query": {
"bool": {
"filter": [
{
"match_phrase_prefix": {
"name": "王"
}
},
{
"range": {
"age": {
"gte": 10,
"lte": 40
}
}
}
]
}
}
}
注意对比查询结果中
_score
字段的值。
10、 _source
默认查询出的文档数据包含全部字段,如果只需要查询需要的字段,可以使用_source
来实现,如下只查询文档中的name
、age
字段:
GET user/_search
{
"query": {
"match_phrase": {
"name": "王重阳"
}
},
"_source": ["name","age"]
}
11、 highlight
highlight
即高亮,可以实现将查询结果中的关键字高亮显示,比如在baidu搜索Elasticsearch
:
结合上图就容易理解它的作用了,原理就是给要高亮的关键字包裹上指定html标签,使用
highlight
时会用到以下几个字段:
-
pre_tags
默认值是<em>
,表示html标签的前半部分 -
post_tags
默认值是</em>
,表示html标签的后半部分 -
fields
表示文档中哪个字段的值和查询的关键字匹配时会被高亮显示
如下,我们查询name
以王
开头的数据:
GET user/_search
{
"query": {
"match_phrase_prefix": {
"name": "王"
}
},
"highlight":{
"pre_tags": "<span style='color:red'>",
"post_tags": "</span>",
"fields": {
"name": {}
}
}
}
结果如下, 查询结果中王
会被指定的html标签包裹,只需从highlight
字段中提取高亮的字段值,最后通过网页渲染即可。
如果我们要从多个字段去查询,例如,查询name
以王
开头并且label
中包含王
的数据,返回结果需要高亮显示,只需要在fields
属性中添加新的字段即可:
GET user/_search
{
"query": {
"bool": {
"should": [
{
"match_phrase_prefix": {
"name": "王"
}
},
{
"match": {
"label": "王"
}
}
]
}
},
"highlight": {
"pre_tags": "<span style='color:red'>",
"post_tags": "</span>",
"fields": {
"name": {},
"label": {}
}
}
}
网友评论