solr Query参数有哪些

49次阅读

共计 5786 个字符，预计需要花费 15 分钟才能阅读完成。

这篇文章主要讲解了“solr Query 参数有哪些”，文中的讲解内容简单清晰，易于学习与理解，下面请大家跟着丸趣 TV 小编的思路慢慢深入，一起来研究和学习“solr Query 参数有哪些”吧！

一. Query 参数
1. CoreQueryParam 查询的参数
1) q: 查询字符串，必须的。
2) q.op: 覆盖 schema.xml 的 defaultOperator（有空格时用 AND 还是用 OR 操作逻辑），一般默认指定。
3) df: 默认的查询字段，一般默认指定。
4) qt: query type，指定查询使用的 Query Handler，默认为“standard”。
5) wt: writer type。指定查询输出结构格式，默认为“xml”。在 solrconfig.xml 中定义了查询输出格式：xml、json、python、ruby、php、phps、custom。
6) echoHandler：是否在查询结果中显示使用的 Query Handler 名称。
7) echoParams：是否显示查询参数。none：不显示；explicit：只显示查询参数；all：所有，包括在 solrconfig.xml 定义的 Query Handler 参数。
8) indent – 返回的结果是否缩进，默认关闭，用 indent=true|on 开启，一般调试 json,php,phps,ruby 输出才有必要用这个参数。
9) version – 查询语法的版本，建议不使用它，由服务器指定默认值。

2. CommonQueryParameters
1) sort：排序，格式：sort= field name + desc|asc [, field name + desc|asc]„ 。
示例：（inStock desc, price asc）表示先 “inStock” 降序, 再 “price” 升序，默认是相关性降序。。
2) start：用于分页定义结果起始记录数，默认为 0。
3) rows：用于分页定义结果每页返回记录数，默认为 10。
4) fq：filter query。使用 Filter Query 可以充分利用 Filter Query Cache，提高检索性能。作用：在 q 查询符合结果中同时是 fq 查询符合的，
例如：q=mm fq=date_time:[20081001 TO 20091031]，找关键字 mm，并且 date_time 是 20081001 到 20091031 之间的。
5) fl：field list。指定返回结果字段。以空格“ ”或逗号“,”分隔。
6) debugQuery：设置返回结果是否显示 Debug 信息。
7) explainOther：设置当 debugQuery=true 时，显示其他的查询说明。
8) defType：设置查询解析器名称。
9) timeAllowed：设置查询超时时间。
10) omitHeader：设置是否忽略查询结果返回头信息，默认为“false”。

二. 查询语法
1. 匹配所有文档：*:*

2. 强制、阻止和可选查询：
1) Mandatory：查询结果中必须包括的(for example, only entry name containing the word make) Solr/Lucene Statement：+make, +make +up ,+make +up +kiss
2) prohibited：(for example, all documents except those with word believe) Solr/Lucene Statement：+make +up -kiss 3) optional：Solr/Lucene Statement：+make +up kiss

3. 布尔操作：AND、OR 和 NOT 布尔操作（必须大写）与 Mandatory、optional 和 prohibited 相似。
1) make AND up = +make +up :AND 左右两边的操作都是 mandatory
2) make || up = make OR up=make up :OR 左右两边的操作都是 optional
3) +make +up NOT kiss = +make +up –kiss
4) make AND up OR french AND Kiss 不可以达到期望的结果，因为 AND 两边的操作都是 mandatory 的。

4. 子表达式查询（子查询）：可以使用“()”构造子查询。
For ex：(make AND up) OR (french AND Kiss)

5. 子表达式查询中阻止查询的限制：
For ex:make (-up): 只能取得 make 的查询结果；要使用 make (-up *:*)查询 make 或者不包括 up 的结果。

6. 多字段 fields 查询：通过字段名加上分号的方式（fieldName:query）来进行查询
For ex：entryNm:make AND entryId:3cdc86e8e0fb4da8ab17caed42f6760c

7. 通配符查询（wildCard Query）：
1) 通配符？和 *：“*”表示匹配任意字符；“？”表示匹配出现的位置。
For ex：ma?*（ma 后面的一个位置匹配），ma??*(ma 后面两个位置都匹配)
2) 查询字符必须要小写：+Ma +be** 可以搜索到结果；+Ma +Be** 没有搜索结果
3) 查询速度较慢，尤其是通配符在首位：主要原因一是需要迭代查询字段中的每个 term，判断是否匹配；二是匹配上的 term 被加到内部的查询，当 terms 数量达到 1024 的时候，查询会失败。
4) Solr 中默认通配符不能出现在首位（可以修改 QueryParser，设置 setAllowLeadingWildcard 为 true）
5) set setAllowLeadingWildcard to true.

8. 模糊查询、相似查询：不是精确的查询，通过对查询的字段进行重新插入、删除和转换来取得得分较高的查询解决（由 Levenstein Distance Algorithm 算法支持）。
1) 一般模糊查询：for ex：make-believ~
2) 门槛模糊查询：对模糊查询可以设置查询门槛，门槛是 0~1 之间的数值，门槛
越高表面相似度越高。For ex：make-believ~0.5、make-believ~0.8、make-believ~0.9

9. 范围查询（Range Query）：Lucene 支持对数字、日期甚至文本的范围查询。结束的范围可以使用“*”通配符。
For ex：
1) 日期范围（ISO-8601 时间 GMT）：sa_type:2 AND a_begin_date:[1990-01-01T00:00:00.000Z TO 1999-12-31T24:59:99.999Z]
2) 数字：salary:[2000 TO *] 3) 文本：entryNm:[a TO a]

10. 日期匹配：YEAR, MONTH, DAY, DATE (synonymous with DAY) HOUR, MINUTE, SECOND, MILLISECOND, and MILLI (synonymous with MILLISECOND)可以被标志成日期。
For ex：
1) r_event_date:[* TO NOW-2YEAR]：2 年前的现在这个时间
2) r_event_date:[* TO NOW/DAY-2YEAR]：2 年前前一天的这个时间

三. 函数查询（Function Query）
函数查询可以利用 numeric 域的值或者与域相关的的某个特定的值的函数，来对文档进行评分。
1. 使用函数查询的方法
这里主要有三种方法可以使用函数查询，这三种 s 方法都是通过 solr http 接口的。
1) 使用 FunctionQParserPlugin。ie: q={!func}log(foo)
2) 使用“_val_”内嵌方法内嵌在正常的 solr 查询表达式中。即，将函数查询写在 q 这个参数中，这时候，我们使用“_val_”将函数与其他的查询加以区别。 ie：entryNm:make _val_:ord(entryNm)
3) 使用 dismax 中的 bf 参数使用明确为函数查询的参数，比如说 dismax 中的 bf（boost function）这个参数。注意：bf 这个参数是可以接受多个函数查询的，它们之间用空格隔开，它们还可以带上权重。所以，当我们使用 bf 这个参数的时候，我们必须保证单个函数中是没有空格出现的，不然程序有可能会以为是两个函数。
For ex：
q=dismax bf= ord(popularity)^0.5 recip(rord(price),1,1000,1000)^0.3 2. 函数的格式（Function Query Syntax) 目前，function query 并不支持 a+b 这样的形式，我们得把它写成一个方法形式，这就是 sum(a,b).

3. 使用函数查询注意事项
1) 用于函数查询的 field 必须是被索引的；
2) 字段不可以是多值的（multi-value）

4. 可以利用的函数（available function）
1) constant：支持有小数点的常量；例如：1.5 ；SolrQuerySyntax:_val_:1.5
2) fieldvalue：这个函数将会返回 numeric field 的值，这个域必须是 indexd 的，非 multiValued 的。格式很简单，就是该域的名字。如果这个域中没有这样的值，那么将会返回 0。
3) ord：对于一个域，它所有的值都将会按照字典顺序排列，这个函数返回你要查询的那个特定的值在这个顺序中的排名。这个域，必须是非 multiValued 的，当没有值存在的时候，将返回 0。例如：某个特定的域只能去三个值，“apple”、“banana”、“pear”，那么 ord（“apple”）=1，ord（“banana”）=2，ord（“pear”）=3. 需要注意的是，ord（）这个函数，依赖于值在索引中的位置，所以当有文档被删除、或者添加的时候，ord（）的值就会发生变化。当你使用 MultiSearcher 的时候，这个值也就是不定的了。
4) rord：这个函数将会返回与 ord 相对应的倒排序的排名。格式: rord(myIndexedField)。
5) sum：这个函数的意思就显而易见啦，它就是表示“和”啦。格式：sum(x,1) 、sum(x,y)、 sum(sqrt(x),log(y),z,0.5)
6) product：product(x,y,…)将会返回多个函数的乘积。格式：product(x,2)、product(x,y)
7) div：div(x,y)表示 x 除以 y 的值，格式：div（1,x）、div(sum(x,100),max(y,1))
8) pow：pow 表示幂值。pow(x,y) =x^y。例如：pow(x,0.5) 表示开方 pow(x,log(y))
9) abs：abs(x)将返回表达式的绝对值。格式：abs(-5)、 abs(x)
10) log：log(x)将会返回基数为 10，x 的对数。格式： log(x)、 log(sum(x,100))
11) Sqrt：sqrt(x) 返回一个数的平方根。格式：sqrt（2）、sqrt(sum(x,100))
12) Map：如果 x =min, 且 x =max, 那么 map(x,min,max,target)=target. 如果 x 不在 [min,max] 这个区间内，那么 map(x,min,max,target)=x. 格式：map(x,0,0,1)
13) Scale：scale(x,minTarget,maxTarget) 这个函数将会把 x 的值限制在 [minTarget,maxTarget] 范围内。 14) query ：query(subquery,default)将会返回给定 subquery 的分数，如果 subquery 与文档不匹配，那么将会返回默认值。任何的查询类型都是受支持的。可以通过引用的方式，也可以直接指定查询串。
例子：q=product(popularity, query({!dismax v= solr rocks}) 将会返回 popularity 和通过 dismax 查询得到的分数的乘积。
q=product(popularity, query($qq) qq={!dismax}solr rocks 跟上一个例子的效果是一样的。不过这里使用的是引用的方式
q=product(popularity, query($qq,0.1) qq={!dismax}solr rocks 在前一个例子的基础上又加了一个默认值。
15) linear： inear(x,m,c)表示 m*x+c , 其中 m 和 c 都是常量，x 是一个变量也可以是一个函数。例如： linear(x,2,4)=2*x+4.
16) Recip：recip(x,m,a,b)=a/(m*x+b)其中，m、a、b 是常量，x 是变量或者一个函数。当 a =b，并且 x = 0 的时候，这个函数的最大值是 1，值的大小随着 x 的增大而减小。例如：recip(rord(creationDate),1,1000,1000)
17) Max： max(x,c)将会返回一个函数和一个常量之间的最大值。例如：max(myfield,0)