solr客户端查询语法

1、常用查询参数说明 
    q - 查询字符串，必须的。 
    fl - 指定返回那些字段内容，用逗号或空格分隔多个。 
    start - 返回第一条记录在完整找到结果中的偏移位置，0开始，一般分页用。 
    rows - 指定返回结果最多有多少条记录，配合start来实现分页。 
    sort - 排序，格式：sort=<field name>+<desc|asc>[,<field name>+<desc|asc>]… 。示例：（inStock desc, price asc）表示先 “inStock” 降序, 再 “price” 升序，默认是相关性降序。 
    wt - (writer type)指定输出格式，可以有 xml, json, php, phps, 后面 solr 1.3增加的，要用通知我们，因为默认没有打开。 
    fq - （filter query）过虑查询，作用：在q查询符合结果中同时是fq查询符合的，例如：q=mm&fq=date_time:[20081001 TO 20091031]，找关键字mm，并且date_time是20081001到20091031之间的。官方文档：http://wiki.apache.org/solr/CommonQueryParameters 
    不常用 
    q.op - 覆盖schema.xml的defaultOperator（有空格时用"AND"还是用"OR"操作逻辑），一般默认指定  “OR”
    df - 默认的查询字段，一般默认指定 
    qt - （query type）指定那个类型来处理查询请求，一般不用指定，默认是standard。 
    其它 
    indent - 返回的结果是否缩进，默认关闭，用 indent=true|on 开启，一般调试json,php,phps,ruby输出才有必要用这个参数。 
    version - 查询语法的版本，建议不使用它，由服务器指定默认值。
   
    solrconfig.xml的配置实例
查询配置(以上参数项都可以配置到该配置文件)
<requestHandler name="/select" class="solr.SearchHandler">
     <lst name="defaults">
       <str name="echoParams">explicit</str>
       <int name="rows">10</int>

       <str name="defType">edismax</str>   //使用的是solr 扩展的查询解析器

      <str name="q.alt">*:*</str>
      <str name="fq">sell_price:[1 TO *]</str>
      <str name="hl">true</str>
      <str name="hl.fl">room_name</str>
           <str name="bf">sum(product(termfreq(room_status,"dzz"),1.2),1)</str> //额外的评分字段，这个是可以影响score的打分的
      <str name="pf">  //要查询的字段
            room_name house_code room_code zr_house_code hire_commissioner_name broker_name rating_address resblock_name district_name subway_station_name subway_line_name
      </str>
      <str name="qf"> //各自段分配的权重
            room_name^5 house_code room_code zr_house_code  hire_commissioner_name broker_name rating_address resblock_name^2 district_name subway_station_name subway_line_name
      </str>
     </lst>
</requestHandler>

另外schema.xml的defaultOperator参数是个很重要的参数，默认是“OR”，意思是要查询的关键词做完分词后的词做 “OR”连接，然后再做查询，而“AND”呢，要至少全包含要搜索的关键词才行。

2、Solr的检索运算符
     “:” 指定字段查指定值，如返回所有值*:*²
     “?”²表示单个任意字符的通配
     “*” 表示多个任意字符的通配（不能在检索的项开始使用*或者?符号）²
     “~”²表示模糊检索，如检索拼写类似于”roam”的项这样写：roam~将找到形如foam和roams的单词；roam~0.8，检索返回相似度在0.8以上的记录。
    ²邻近检索，如检索相隔10个单词的”apache”和”jakarta”，”jakarta apache”~10
     “^”²控制相关度检索，如检索jakarta apache，同时希望去让”jakarta”的相关度更加好，那么在其后加上”^”符号和增量值，即jakarta^4 apache
     布尔操作符AND、||²
     布尔操作符OR、²&&
     布尔操作符NOT、!、-²（排除操作符不能单独与项使用构成查询）
     “+” 存在操作符，要求符号”+”后的项必须在文档相应的域中存在²
     ( ) 用于构成子查询²
    ² [] 包含范围检索，如检索某时间段记录，包含头尾，date:[200707 TO 200710]
     {}²不包含范围检索，如检索某时间段记录，不包含头尾
    date:{200707 TO 200710}
     " 转义操作符，特殊字符包括+ -² && || ! ( ) { } [ ] ^ ” ~ * ? : "
    
非空数据的查询 比如：fq=fcode:['' TO *] 查询fcode非空的数据

取反实例：fq=!fstate:1

3、facet查询

分类统计 facet 
    q=*:*&facet=true&facet.field=cat&facet.field=inStock  //按cat  inStock进行分类统计
   
    q=ipod&facet=true&facet.query=price:[0 TO 100]&facet.query=price:[100 TO *]  //区间统计 价格在0-100 和100-无穷大的

--solr的分组查询（facet）
http://IP:port/solr/room/select?rows=0&q=bizcircle_code:XXXXXX&facet=on
&facet.field=resblock_id&facet.field=resblock_name&facet.limit=3   //同一个bizcircle_code下的 前三个resblock 各自的文档数量

在做solr查询的时候，solr提供了很多参数来扩展它自身的强大功能！以下是使用频率最高的一些参数！ 

 

1、常用 

q - 查询字符串，这个是必须的。如果查询所有*:* ，根据指定字段查询（Name:张三 AND Address:北京）

fq - （filter query）过虑查询，作用：在q查询符合结果中同时是fq查询符合的，例如：q=Name:张三&fq=CreateDate:[20081001 TO 20091031],找关键字mm，并且CreateDate是20081001

fl - 指定返回那些字段内容，用逗号或空格分隔多个。 

start - 返回第一条记录在完整找到结果中的偏移位置，0开始，一般分页用。 

rows - 指定返回结果最多有多少条记录，配合start来实现分页。 

sort - 排序，格式：sort=<field name>+<desc|asc>[,<field name>+<desc|asc>]… 。示例：（score desc, price asc）表示先 “score” 降序, 再 “price” 升序，默认是相关性降序。 

wt - (writer type)指定输出格式，可以有 xml, json, php, phps。 

fl表示索引显示那些field( *表示所有field,如果想查询指定字段用逗号或空格隔开（如：Name,SKU,ShortDescription或Name SKU ShortDescription【注：字段是严格区分大小写的】）) 

q.op 表示q 中 查询语句的 各条件的逻辑操作 AND(与) OR(或) 

hl 是否高亮 ,如hl=true

hl.fl 高亮field ,hl.fl=Name,SKU

hl.snippets :默认是1,这里设置为3个片段

hl.simple.pre 高亮前面的格式 

hl.simple.post 高亮后面的格式 

facet 是否启动统计 

facet.field  统计field 

【注：以上是比较常用的参数，当然具体的参数使用还是多看Solr官方的技术文档以及一些大神的博文日志，这里只是抛砖引玉】

 

二、 Solr运算符

1. “:” 指定字段查指定值，如返回所有值*:*

2. “?” 表示单个任意字符的通配

3. “*” 表示多个任意字符的通配（不能在检索的项开始使用*或者?符号）

4. “~” 表示模糊检索，如检索拼写类似于”roam”的项这样写：roam~将找到形如foam和roams的单词；roam~0.8，检索返回相似度在0.8以上的记录。

5. 邻近检索，如检索相隔10个单词的”apache”和”jakarta”，”jakarta apache”~10

6. “^” 控制相关度检索，如检索jakarta apache，同时希望去让”jakarta”的相关度更加好，那么在其后加上”^”符号和增量值，即jakarta^4 apache

7. 布尔操作符AND、||

8. 布尔操作符OR、&&

9. 布尔操作符NOT、!、- （排除操作符不能单独与项使用构成查询）
10. “+” 存在操作符，要求符号”+”后的项必须在文档相应的域中存在
11. ( ) 用于构成子查询
12. [] 包含范围检索，如检索某时间段记录，包含头尾，date:[200707 TO 200710]
13. {} 不包含范围检索，如检索某时间段记录，不包含头尾
date:{200707 TO 200710}
14. / 转义操作符，特殊字符包括+ - && || ! ( ) { } [ ] ^ ” ~ * ? : /

 注：①“+”和”-“表示对单个查询单元的修饰，and 、or 、 not 是对两个查询单元是否做交集或者做差集还是取反的操作的符号

　　 比如:AB:china +AB:america ,表示的是AB:china忽略不计可有可无，必须满足第二个条件才是对的,而不是你所认为的必须满足这两个搜索条件

　　 如果输入:AB:china AND AB:america ,解析出来的结果是两个条件同时满足，即+AB:china AND +AB:america或+AB:china +AB:america

　　总而言之，查询语法：  修饰符 字段名:查询关键词 AND/OR/NOT 修饰符 字段名:查询关键词

三、 Solr查询语法

1.最普通的查询，比如查询姓张的人（ Name:张）,如果是精准性搜索相当于SQL SERVER中的LIKE搜索这需要带引号（""）,比如查询含有北京的（Address:"北京"）

2.多条件查询，注：如果是针对单个字段进行搜索的可以用（Name:搜索条件加运算符(OR、AND、NOT) Name：搜索条件）,比如模糊查询（ Name:张 OR Name:李 ）单个字段多条件搜索不建议这样写，一般建议是在单个字段里进行条件筛选，如（ Name:张 OR 李），多个字段查询（Name:张 + Address:北京 ）

3.排序，比如根据姓名升序（Name asc）,降序（Name desc）

facet使用的参考例子

引用别人的一篇博客：http://martin3000.iteye.com/blog/1330106

http://www.blogjava.net/conans/articles/379556.html