1. URI Search 简介
可以通过提供请求参数来使用 URI 来执行搜索请求。
这里给出一个例子:
GET twitter/_search?q=user:kimchy
并给出一个示例响应:
{
"timed_out": false,
"took": 62,
"_shards":{
"total" : 1,
"successful" : 1,
"failed" : 0
},
"hits":{
"total" : 1,
"max_score": 1.3862944,
"hits" : [
{
"_index" : "twitter",
"_type" : "_doc",
"_id" : "0",
"_score": 1.3862944,
"_source" : {
"user" : "kimchy",
"date" : "2009-11-15T14:12:12",
"message" : "trying out Elasticsearch",
"likes": 0
}
}
]
}
}
2. URI 中允许使用的参数有:
- q : 查询字符串(映射到 query_string 查询,有关更多详细信息,请参阅查询字符串查询)
- df : 在查询中未定义查询字段时使用的默认字段。
- analyzer : 分析查询字符串时使用的分析器名称。
- analyze_wildcard : 是否对通配符和查询前缀进行分词。默认为 false。
- batched_reduce_size: 一次在coordinating node上面进行reduce的result的数量,可以防止内存过载。
- default_operator : 要使用的默认运算符,可以是 AND 或 OR 。默认为 OR。
- lenient : 如果设置为 true 将导致格式校验产生的失败(例如向数字字段提供文本)被忽略。默认为 false。
- explain : 对于每个命中,包含对如何计算命中的score的解释。
- _source : 设置为false之后不会召回 _source 字段。您还可以使用 _source_include&_source_exclude 检索文档的一部分(有关更多详细信息,请参阅请求主体文档)。
- stored_fields : 为每次命中返回文档的stored fields,逗号分隔。未指定任何值将不会返回任何字段。
- sort : 排序执行。可以是 fieldName 或
fieldName:asc/fieldName:desc
的形式。 fieldName 可以是文档中的实际字段,也可以是指示基于分数排序的特殊 _score 名称。可以有几个 sort 参数(顺序很重要)。 - track_scores : 排序时,设置为 true 以便仍然跟踪分数并将其作为每次匹配的一部分返回。
- timeout : 搜索超时,将搜索请求限制为在指定的时间值内执行,在时间到了会返回已经查出来的部分结果。默认为无超时。
- terminate_after : 要为每个分片收集的文档的最大数量,到达时,查询执行将提前终止。如果设置,响应将有布尔型字段 terminated_early 以指示查询执行是否实际已提前终止。默认为无terminate_after。
- from : 从命中的索引开始返回。默认值为 0。
- size : 要返回的匹配数。默认值为 10。
- search_type : 要执行的搜索操作的类型。可以是 dfs_query_then_fetch 或 query_then_fetch。默认为 query_then_fetch。有关可以执行的不同类型搜索的更多详细信息,请参阅搜索类型。
- allow_partial_search_results: 是否在发生错误或者超时的时候返回部分结果,默认为true,允许。