Solr查询语言 JSON Request API
Solr查询语言 JSON Request API
大明搜索 发表于8个月前
Solr查询语言 JSON Request API
  • 发表于 8个月前
  • 阅读 465
  • 收藏 12
  • 点赞 1
  • 评论 0

新睿云服务器60天免费使用,快来体验!>>>   

摘要: JSON Request API是一套优雅高效查询语法,尤其在搜索统计方面带全新的体验,既简洁又漂亮。绝对是一次非常美好的体验。

一、背景与动机

JSON Request API是由noggit作者(同时也Solr Committer Leader)在Solr.5.3带来新特性,意在改善Solr原来复杂且又丑陋查询语法。

注:JSON Request API与Solr API v2并不是一回来,JSON Request API是一种新型Solr Query DSL。API v2新版本查询API,是基于Restful API实现的。当然JSON Request API显然是基于JSON实现的咯。 不过Request API还是API v2都是Solr学习ElasticSearch靠近的表现。

以前想写简单查询其实也没有很复杂,就是写个q参数,然后指定一下rowssort嘛,但是对于用Solr来做统计相关工作的同学,还是觉得挺烦的。因为它

  1. 冗长,没有结构,容易出错,难于校验和debug。f.facet_field_name.facet.range.start=5
  2. 没有数据类型,整个世界都是String,缺乏结构,不便于编程
  3. 对服务端而言,解释得也相当复杂。

总之,就是有一系列问题。所以在Solr5.3,Yonik小哥带来这个。当然,我们Solr的JSON解析器用的就是Noggit。

Noggit是非常牛比,非常最效,非常新颖的JSON解析器。她是流式JSON解释器,同时她还扩展JSON格式,使得她的结构更加简洁,优雅。想了解她更牛比之处请阅读noggit项目首页。

这就是JSON Request API出现的背景,当然动机就是针对这些痛点进行优化,一方面有利于推广Solr的搜索统计功能;二方面优化搜索解析效率、优化使用体验。

二、用法

在过去,我写Blog从不写用法一类的Blog。主要是这一类文章写的非常多,这次为什么要写呢,原因有二。一,Solr6.6正式推出这套API;二,貌似并没多少人关注她。这么好的特征,不能让她一直默默无闻。

虽然Noggit已经非常简洁好看,但是她在浏览器的地址栏里编辑还非常不好方便的。但我依然她觉得非常好,特别在她提供一系列非常好用的Facet Statistics & Aggregations Function。之前没有她的时候,我们要写这些查询,非常苦痛的,除了可能需要用到stats查询之外,还很有用可能需要用到非常用的Query Function。(这也可能就是Solr一直很搜索的原因吧。)

因此,非常有必要来推广她,不能让这个世界都是ElasticSearch

好了,回归正题,先看来几个Query。

Query #1. 直接POST

$ curl http://solr.daming.com/solr/daming -d '{
	query : "helloWorld"
}'

非常清淅,特别是熟悉ElasticSearch的同学们,可谓是ElasticSearch转向Solr的一条桥梁。

query #2. HttpGet Method

JSON Request API作为新版的query api,其实它也是相当成熟了的,功能也相当丰富,也基本兼容旧版API。当是HttpGet是需要一个参数来接收我们新版JSON Request内容的。通过Parameter json={}的方式来接收JSON Request API的查询语句,且新版API与旧版API完全兼容,即是可以一起来描述一个查询请求。

这种情况下,JSON Request API完全就是原来查询语法的一个扩展,即是多出一个叫json的新参数。

$ curl http://localhost:8983/solr/query -d 'json={query:"hero"}&fq=author:brandon'

Query #3 来看一个完整的示例

老实说,JSONS Request API定义真的是非常人性化、贴近自然语言。

{
  query : "*:*",
  filter : [
    "author:brandon",
    "genre_s:fantasy"
  ],
  offset : 0,
  limit : 5,
  fields : ["title","author"],  // we could also use the string form "title,author"
  sort : "sequence_i desc",
 
  facet : {  // the JSON Facet API is nicely integrated as well
    avg_price : "avg(price)",
    top_authors : {terms : author}
  }
}
  • 参数解释 我以为新版本的API参数名并不需要加于描述,看名字即可。
  1. query,等同于q
  2. filter,等同于fq,注意新版API是结构化的,并且是有类型的。因为我们并不需要向以前那么样拼一堆的fq,如今如只需要一个数组即可。
  3. offset,等同于start
  4. limit,等同于rows
  5. sort,还是sort
  6. facet,新款Facet API,具体下篇再继续讨论。

跟旧版一样,并不需要一个请求里为所有参数进行赋值。同时所有参数都是可以缺省,当新旧版同语义的参数出现时,由旧版本参数值覆盖新版。 按Yonik的说法,JSON Request API属于二级查询,因为它由json=开始。那么即是上级会覆盖下级。

noggit json string完全支持扁平化,意思是说我们通过打点的方式把查询语句变得扁平化,然后拼在上级结构里。此时同样满足上级覆盖下级的基本规则。

三、后语

Solr拥有一套完整、非常强大且复杂的查询语法,所以如果JSON Request API只是这样就结束的话,那就一点都不Solr了。因此还下一篇,下篇我们来聊聊JSON Facet API,这是才我为什么一直想要来介绍一下JSON Request API的原因。 在基本查询部分,JSON Request API的确没什么优势,我也建议你继续旧语法。但如果你需要用Solr来做统计的话,尽管Solr的Sql让你很失望,但请相信我,JSON Facet API会让你耳目一新,然后爱上她的。

参考文章: 大神Yonik博客

  • 打赏
  • 点赞
  • 收藏
  • 分享
共有 人打赏支持
粉丝 11
博文 6
码字总数 15125
作品 1
×
大明搜索
如果觉得我的文章对您有用,请随意打赏。您的支持将鼓励我继续创作!
* 金额(元)
¥1 ¥5 ¥10 ¥20 其他金额
打赏人
留言
* 支付类型
微信扫码支付
打赏金额:
已支付成功
打赏金额: