文档章节

Solr查询语言 JSON Request API

大明搜索
 大明搜索
发布于 2017/06/28 15:40
字数 1402
阅读 483
收藏 12

一、背景与动机

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
广州
高级程序员
Solr学习总结(一)Solr介绍

  最近一直在搞Solr的问题,研究Solr 的优化,搜索引擎的bug修改等,这几天终于有时间,闲下来总结分享,以便大家参考,与大家一起来共同学习。   Solr是一个基于Lucene的全文搜索引擎,同...

章为忠
2015/12/10
0
0
Solr搜索引擎

1、solr的下载地址为http://pan.baidu.com/s/1kUAJYmF 2、solr的安装 solr下载完毕后解压开,使用前需要配置jdk1.8的环境变量 选中bin目录下的startup.bat启动就可以。 3、solr的使用 solr访...

0了凡0
2016/09/11
5
0
Apache Solr 5.2.1 发布,Java 全文搜索引擎

Apache Solr 5.2.1 发布,值得关注的更新如下: Fix javascript bug introduced by SOLR-7409 that breaks the dataimport screen in the admin UI Faceting on a numeric field with a uniq......

oschina
2015/06/16
2.9K
6
开发者都应该知道的开源搜索引擎

本文介绍若干款开源搜索引擎,他们具有不同的特性,总之都很强大。对于开发者来说,应该了解。 1、企业搜索解决方案 Constellio Constellio 是一个开源的搜索解决方案,适合企业级的搜索。基...

老枪
2011/06/01
2.9K
7
Apache Solr 5.4.1 发布,全文搜索服务器

Apache Solr 5.4.1 发布,更新如下: Bug Fixes (8) SOLR-8460: /analysis/field could throw exceptions for custom attributes. (David Smiley, Uwe Schindler) SOLR-8373: KerberosPlugin......

淡漠悠然
2016/01/22
2.3K
10

没有更多内容

加载失败,请刷新页面

加载更多

原型模式

1、原型模式-定义 用原型实例指定创建对象的种类,并且通过拷贝这些原型创建新的对象 克隆(浅度克隆->拷贝值类型或者引用,深度克隆->创建新的对象,开辟新的内存) 例如客户端知道抽象Pro...

阿元
今天
50
0
awk命令扩展使用操作

awk 中使用外部shell变量 示例1 [root@centos01 t1022]# A=888[root@centos01 t1022]# echo "" | awk -v GET_A=$A '{print GET_A}'888[root@centos01 t1022]# echo "aaaaaaaaaaaaa" | aw......

野雪球
今天
44
0
深入解析MySQL视图VIEW

Q:什么是视图?视图是干什么用的? A:视图(view)是一种虚拟存在的表,是一个逻辑表,本身并不包含数据。作为一个select语句保存在数据字典中的。   通过视图,可以展现基表的部分数据;...

IT--小哥
今天
48
0
虚拟机学习之二:垃圾收集器和内存分配策略

1.对象是否可回收 1.1引用计数算法 引用计数算法:给对象中添加一个引用计数器,每当有一个地方引用它时,计数器值就加1;当引用失效时,计数器值就减1;任何时候计数器值为0的对象就是不可能...

贾峰uk
今天
48
0
smart-doc功能使用介绍

smart-doc从8月份底开始开源发布到目前为止已经迭代了几个版本。在这里非常感谢那些敢于用smart-doc去做尝试并积极提出建议的社区用户。因此决定在本博客中重要说明下smart-doc的功能,包括使...

上官胡闹
昨天
47
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部