Solr查询语法

http://blog.javachen.com/2014/03/03/solr-query-syntax/

查询参数

常用：

• 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。
• fq - （filter query）过虑查询，作用：在q查询符合结果中同时是fq查询符合的，例如：q=mm&fq=date_time:[20081001 TO 20091031]，找关键字mm，并且date_time是20081001到20091031之间的

不常用：

• defType：
• q.op - 覆盖schema.xml的defaultOperator（有空格时用"AND"还是用"OR"操作逻辑），一般默认指定
• df - 默认的查询字段，一般默认指定
• qt - （query type）指定那个类型来处理查询请求，一般不用指定，默认是standard。

其它：

• indent - 返回的结果是否缩进，默认关闭，用 indent=true|on 开启，一般调试json,php,phps,ruby输出才有必要用这个参数。
• version- 查询语法的版本，建议不使用它，由服务器指定默认值。

检索运算符

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

示例

• 1. 查询所有

http://localhost:8080/solr/primary/select?q=*:*

• 2. 限定返回字段

http://localhost:8080/solr/primary/select?q=*:*&fl=productId

表示：查询所有记录，只返回productId字段

• 3. 分页

http://localhost:8080/solr/primary/select?q=*:*&fl=productId&rows=6&start=0

表示：查询前六条记录，只返回productId字段

• 4. 增加限定条件

http://localhost:8080/solr/primary/select?q=*:*&fl=productId&rows=6&start=0&fq=category:2002&fq=namespace:d&fl=productId+category&fq=en_US_city_i:1101

表示：查询category=2002、en_US_city_i=110以及namespace=d的前六条记录，只返回productId和category字段

• 5. 添加排序

http://localhost:8080/solr/primary/select?q=*:*&fl=productId&rows=6&start=0&fq=category:2002&fq=namespace:d&sort=category_2002_sort_i+asc

表示：查询category=2002以及namespace=d并按category_2002_sort_i升序排序的前六条记录，只返回productId字段

• 6. facet查询

现实分组统计结果

http://localhost:8080/solr/primary/select?q=*:*&fl=productId&fq=category:2002&facet=true&facet.field=en_US_county_i&facet.field=en_US_hotelType_s&facet.field=price_p&facet.field=heatRange_i

http://localhost:8080/solr/primary/select?q=*:*&fl=productId&fq=category:2002&facet=true&facet.field=en_US_county_i&facet.field=en_US_hotelType_s&facet.field=price_p&facet.field=heatRange_i&facet.query=price_p:[300.00000+TO+*]

高亮

hl-highlight，h1=true，表示采用高亮。可以用h1.fl=field1,field2 来设定高亮显示的字段。

• hl.fl:用空格或逗号隔开的字段列表。要启用某个字段的 highlight功能，就得保证该字段在schema中是stored。如果该参数未被给出，那么就会高 亮默认字段 standard handler会用df参数，dismax字段用qf参数。你可以使用星号去方便的高亮所有字段。如果你使用了通配符，那么要考虑启用 。
• hl.requireFieldMatch:如果置为true，除非该字段 的查询结果不为空才会被高亮。它的默认值是false，意味 着它可能匹配某个字段却高亮一个不同的字段。如果hl.fl使用了通配符，那么就要启用该参数。尽管如此，如果你的查询是all字段（可能是使用 copy-field 指令），那么还是把它设为false，这样搜索结果能表明哪个字段的查询文本未被找到
• hl.usePhraseHighlighter:如果一个查询中含有短语（引号框起来的）那么会保证一定要完全匹配短语的才会被高亮。
• hl.highlightMultiTerm 如果使用通配符和模糊搜索，那么会确保与通配符匹配的term会高亮。默认为false，同时hl.usePhraseHighlighter要为true。
• hl.snippets： 这是highlighted片段的最大数。默认值为1，也几乎不会修改。如果某个特定的字段的该值被置为0（如f.allText.hl.snippets=0），这就表明该字段被禁用高亮了。你可能在hl.fl=*时会这么用。
• hl.fragsize: 每个snippet返回的最大字符数。默认是100.如果为0，那么该字段不会被fragmented且整个字段的值会被返回。大字段时不会这么做。
• hl.mergeContiguous: 如果被置为true，当snippet重叠时会merge起来。
• hl.maxAnalyzedChars: 会搜索高亮的最大字符，默认值为51200，如果你想禁用，设为-1
• hl.alternateField: 如果没有生成snippet（没有terms 匹配），那么使用另一个字段值作为返回。
• hl.maxAlternateFieldLength: 如果hl.alternateField启用，则有时需要制定alternateField的最大字符长度，默认0是即没有限制。所以合理的值是应该为hl.snippets * hl.fragsize这样返回结果的大小就能保持一致。
• hl.formatter:一个提供可替换的formatting算法的扩展点。默认值是simple，这是目前仅有的选项。显然这不够用，你可以看看org.apache.solr.highlight.HtmlFormatter.java 和 solrconfig.xml 中highlighting元素是如何配置的。 注意在不论原文中被高亮了什么值的情况下，如预先已存在的em tags，也不会被转义，所以在有时会导致假的高亮。 -hl.fragmenter:这个是solr制定fragment算法的扩展点。 gap是默认值。regex是另一种选项，这种选项指明highlight的边界由一个正则表达式确定。这是一种非典型 的高级选项。为了知道默认设置和fragmenters (and formatters)是如何配置的，可以看看 solrconfig.xml 中的highlight段。
• hl.regex.pattern:正则表达式的pattern
• hl.regex.slop:这是hl.fragsize能变化以适应正则表达式的因子。默认值是0.6，意思是如果 hlfragsize=100 那么fragment的大小会从40-160.

http://www.111cn.net/jsp/Java/65040.htm

配置好solr后，可以通过web管理界面进行管理和查询。web界面基本列出了大多数查询参数，可以通过这个学习lucene的查询语法。
solr的查询解析是通过queryParser来配置的（solrconfig.xml），一般我们用默认的即可。其各参数含义与用法简单解释如下：
q：查询输入，必须。可以使用运算符
fq：过滤查询。可以使用运算符
sort：排序的字段，格式为field score，多个字段之间用逗号隔开，比如sum(x_f, y_f) desc, price asc，默认是score desc
start：从哪一行开始
rows：获取多少行
fl：查询要输出的字段，字段之间用逗号隔开，比如title,price,seller，星号代表所有，默认就是星号。
df:定义查询时默认的查询field。
wt：返回的数据类型，可以是JSON、XML、python、ruby、php、csv等格式。
indent：true/false，返回的XML格式是否需要缩进(格式化展示)，默认为false
debugQuery：调试查询，会输出查询过程的一些参数。
 
高亮相关：
高亮是通过searchComponent来配置的，在solrconfig.xml中配置名为highlight的searchComponent即可，默认的实现是solr.HighlightComponent。
hl：true/false,是否高亮显示
hl.fl：高亮显示的字段
hl.example.pre：高亮显示的前缀
hl.exapmle.post：高亮显示的后缀
hl.requireFieldMatch：是否只在查询指定的field（只有当hl.usePhraseHighlighter为true时才生效）高亮显示，默认是在所有field都高亮
hl.usePhraseHighlighter：true/false,使用SpanScorer高亮查询短语
hl.highlightMultiTerm：true/false,如果SpanScorer被启用，这个参数针对前缀/模糊/范围/通配符等开启高亮显示
 
facet：true/false
facet是solr的高级搜索功能之一，可以给用户提供更友好的搜索体验（类似于面包屑导航的功能）。在搜索关键字的同时,能够按照 facet指定的字段进行分组统计。比如商品的分类、商品的规格等。facet的字段必须被索引，无须分词（分词意义不大），也无须存储。详细可参考 《Solr的facet查询》
facet的查询结果返回字段为facet_counts，与responseHeader、response同级。
facet.query：类似于filter的语法，对任意字段进行筛选
facet.field：需要进行facet的字段
facet.prefix：对facet字段的前缀过滤
facet.sort：true/false，对facet以哪种顺序返回，true为按照count值从大到小排序，默认为true
 
spellcheck：拼写检查
spellcheck是通过component的方式实现的，你可以在solrconfig.xml文件中配置searchComponent来完成拼写 检查的功能，默认的实现是solr.SpellCheckComponent，具体的配置参数和实现原理可以看这里 《spellCheckComponent》
 
spatial：空间搜索
spatial是专门针对空间数据进行搜索的，空间位置的索引和存储fieldType是LatLonType或者 SpatialRecursivePrefixTreeFieldType，通过使用空间搜索，你可以对点、面等数据建立索引，以圆形、方形或其他形状进 行范围搜索，以及对搜索结果按距离排序等等，具体的配置参数和实现原理可以看这里《SpatialSearch》
 
 
检索运算符：
冒号":"： field:value结构查询，表示字段field值为value的查询。
通配符：？(任意一个字符) *(任意字符)
布尔操作：AND(并且，同&&) OR(或者，同||) +(包含) -(不包含) NOT(同!)，注意AND、OR、NOT均为大写
范围：[A TO B](从A到B之间，包含A和B,注意TO大写)，{A TO B}（从A到B之间，不包含A和B,注意TO大写）
子运算：()括号跟数学表达式上的差不多，比如：(瓜 OR 傻) AND 男人
模糊检索：~表示模糊检索，比如：roam~将找到形如foam和roams的单词；roam~0.8，检索返回相似度在0.8以上的记录
控制相关度：^表示相关度，如检索jakarta apache，同时希望让”jakarta”的相关度更加好，那么在其后加上”^”符号和增量值，即jakarta^4 apache