📅  最后修改于: 2020-10-30 14:17:38             🧑  作者: Mango
该API用于在Elasticsearch中搜索内容。用户可以通过发送带有查询字符串作为参数的get请求进行搜索,或者可以在发布请求的消息正文中发布查询。主要是所有搜索API都是多索引,多类型的。
Elasticsearch允许我们搜索所有索引或某些特定索引中存在的文档。例如,如果我们需要搜索名称包含“ central”的所有文档,则可以执行以下操作:
GET /_all/_search?q=city:paprola
在运行上面的代码时,我们得到以下响应-
{
"took" : 33,
"timed_out" : false,
"_shards" : {
"total" : 7,
"successful" : 7,
"skipped" : 0,
"failed" : 0
},
"hits" : {
"total" : {
"value" : 1,
"relation" : "eq"
},
"max_score" : 0.9808292,
"hits" : [
{
"_index" : "schools",
"_type" : "school",
"_id" : "5",
"_score" : 0.9808292,
"_source" : {
"name" : "Central School",
"description" : "CBSE Affiliation",
"street" : "Nagan",
"city" : "paprola",
"state" : "HP",
"zip" : "176115",
"location" : [
31.8955385,
76.8380405
],
"fees" : 2200,
"tags" : [
"Senior Secondary",
"beautiful campus"
],
"rating" : "3.3"
}
}
]
}
}
使用统一资源标识符,可以在搜索操作中传递许多参数-
S.No | Parameter & Description |
---|---|
1 |
Q This parameter is used to specify query string. |
2 |
lenient This parameter is used to specify query string.Format based errors can be ignored by just setting this parameter to true. It |
3 |
fields This parameter is used to specify query string. |
4 |
sort We can get sorted result by using this parameter, the possible values for this parameter is fieldName, fieldName:asc/fieldname:desc |
5 |
timeout We can restrict the search time by using this parameter and response only contains the hits in that specified time. By default, there is no timeout. |
6 |
terminate_after We can restrict the response to a specified number of documents for each shard, upon reaching which the query will terminate early. By default, there is no terminate_after. |
7 |
from The starting from index of the hits to return. Defaults to 0. |
8 |
size It denotes the number of hits to return. Defaults to 10. |
我们还可以在请求正文中使用查询DSL指定查询,在前面的章节中已经给出了许多示例。这里给出一个这样的例子-
POST /schools/_search
{
"query":{
"query_string":{
"query":"up"
}
}
}
在运行上面的代码时,我们得到以下响应-
{
"took" : 11,
"timed_out" : false,
"_shards" : {
"total" : 1,
"successful" : 1,
"skipped" : 0,
"failed" : 0
},
"hits" : {
"total" : {
"value" : 1,
"relation" : "eq"
},
"max_score" : 0.47000363,
"hits" : [
{
"_index" : "schools",
"_type" : "school",
"_id" : "4",
"_score" : 0.47000363,
"_source" : {
"name" : "City Best School",
"description" : "ICSE",
"street" : "West End",
"city" : "Meerut",
"state" : "UP",
"zip" : "250002",
"location" : [
28.9926174,
77.692485
],
"fees" : 3500,
"tags" : [
"fully computerized"
],
"rating" : "4.5"
}
}
]
}
}