Solr的函数查询Function Queries

￡神魔★判官ぃ 2022-07-13 04:09 192阅读 0赞

**摘要：** 函数查询允许你使用一个或多个数字字段的真实值生成一个相关性分数，函数查询在`standard`、`DisMax`、`eDisMax`下都能使用。  
查询函数可以是常量、字段或者其他函数的组合。使用函数可以影响结果的排序。本文整理自[Solr官方文档][Solr]。

## 使用Function Query ##

1.  直接向`QParser`指定函数参数，如`func`或`frange`：  
    `q={!func}div(popularity,price)&fq={!frange l=1000}customer_ratings`
2.  在排序时使用：  
    `sort=div(popularity,price) desc, score desc`
3.  在查询结果中预处理一些输出字段  
    `&fl=sum(x, y),id,a,b,c,score`
4.  指定函数的一个参数：在`EDisMax`中指定`boost`参数，在`DisMax`中指定`bf`参数。  
    `q=dismax&bf="ord(popularity)^0.5 recip(rord(price),1,1000,1000)^0.3"`
5.  在Lucene的`QParser`中使用`_val_`关键字指定函数：  
    `q=_val_:mynumericfield _val_:"recip(rord(myfield),1,2,3)"`

## Solr中的可用函数 ##

<table> 
 <thead> 
  <tr> 
   <th>函数</th> 
   <th>说明</th> 
   <th>举例</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>abs(x)</td> 
   <td>返回绝对值</td> 
   <td>abs(-5)</td> 
  </tr> 
  <tr> 
   <td>“constant”</td> 
   <td>指定一个浮点数</td> 
   <td>1.5</td> 
  </tr> 
  <tr> 
   <td>def(“field”,value)</td> 
   <td>默认值,当指定字段不存在时，返回默认值</td> 
   <td>def(rating,5)</td> 
  </tr> 
  <tr> 
   <td>div(x,y)</td> 
   <td>除法,x除以y</td> 
   <td>div(1,5)</td> 
  </tr> 
  <tr> 
   <td>dist</td> 
   <td>计算两点之间的距离</td> 
   <td>dist(2, x, y, 0, 0)</td> 
  </tr> 
  <tr> 
   <td>docfreq(field,val)</td> 
   <td>返回某值在某字段出现的次数</td> 
   <td>docfreq(title,’solr’)</td> 
  </tr> 
  <tr> 
   <td>field(“field”)</td> 
   <td>返回该<code>field</code>的索引数量</td> 
   <td>field(“title”)</td> 
  </tr> 
  <tr> 
   <td>hsin</td> 
   <td>曲面圆弧上两点之间的距离</td> 
   <td>hsin(2, true, x, y, 0, 0)</td> 
  </tr> 
  <tr> 
   <td>idf</td> 
   <td>Inverse document frequency倒排文档频率</td> 
   <td>idf(“field”,’solr’)</td> 
  </tr> 
  <tr> 
   <td>if</td> 
   <td>if(test,value1,value2)</td> 
   <td>if(termfreq (title,’solr’), popularity,42)</td> 
  </tr> 
  <tr> 
   <td>linear(x,m,c)</td> 
   <td>就是m*x+c，等同于sum(product(m,x),c)</td> 
   <td>linear(1,2,4)=1x2+4=6</td> 
  </tr> 
  <tr> 
   <td>log(x)</td> 
   <td>以10为底，x的对数</td> 
   <td>log(sum(x,100))</td> 
  </tr> 
  <tr> 
   <td>map(x,min,max,target)</td> 
   <td>映射一个在最小值min与最大值max之间，又包含target的值</td> 
   <td>map(x,0,0,1)</td> 
  </tr> 
  <tr> 
   <td>max(x,y,…)</td> 
   <td>返回最大值</td> 
   <td>max(2,3,0)</td> 
  </tr> 
  <tr> 
   <td>maxdoc</td> 
   <td>返回索引的个数，查看有多少文档，包括被标记为删除状态的文档</td> 
   <td>maxdoc()</td> 
  </tr> 
  <tr> 
   <td>min(x,y,…)</td> 
   <td>返回最小值</td> 
   <td>min(2,3,0)</td> 
  </tr> 
  <tr> 
   <td>ms</td> 
   <td>返回两个参数间毫秒级的差别</td> 
   <td>ms(datefield1, 2000-01-01T00:00:00Z)</td> 
  </tr> 
  <tr> 
   <td>norm(field)</td> 
   <td>返回该字段索引值的范数</td> 
   <td>norm(title)</td> 
  </tr> 
  <tr> 
   <td>numdocs</td> 
   <td>返回索引的个数，查看有多少文档，不包括被标记为删除状态的文档</td> 
   <td>numdocs()</td> 
  </tr> 
  <tr> 
   <td>ord</td> 
   <td>根据顺序索引返回结果</td> 
   <td>ord(title)</td> 
  </tr> 
  <tr> 
   <td>pow(x,y)</td> 
   <td>返回x的y次方</td> 
   <td>pow(x,log(y))</td> 
  </tr> 
  <tr> 
   <td>product(x,y)</td> 
   <td>返回多个值的乘机</td> 
   <td>product(x,2)</td> 
  </tr> 
  <tr> 
   <td>query</td> 
   <td>返回给定的子查询的得分,或者文档不匹配的默认值值</td> 
   <td>query(subquery, default)</td> 
  </tr> 
  <tr> 
   <td>recip(x,m,a,b)</td> 
   <td>相当于a/(m*x+b)，a,m,b是常量，x是变量</td> 
   <td>recip(myfield,m,a,b)</td> 
  </tr> 
  <tr> 
   <td>rord</td> 
   <td>按<code>ord</code>的结果反序返回</td> 
   <td>rord(title)</td> 
  </tr> 
  <tr> 
   <td>scale</td> 
   <td>返回一个在最大值和最小值之间的值</td> 
   <td>scale(x,1,2)</td> 
  </tr> 
  <tr> 
   <td>sqedist</td> 
   <td>平方欧氏距离计算</td> 
   <td>sqedist(x_td, y_td, 0, 0)</td> 
  </tr> 
  <tr> 
   <td>sqrt</td> 
   <td>返回指定值的平方根</td> 
   <td>sqrt(x)sqrt(100)</td> 
  </tr> 
  <tr> 
   <td>strdist</td> 
   <td>计算两个字符串之间的距离</td> 
   <td>strdist(“SOLR”,id,edit)</td> 
  </tr> 
  <tr> 
   <td>sub</td> 
   <td>返回x-y</td> 
   <td>sub(myfield,myfield2)</td> 
  </tr> 
  <tr> 
   <td>sum(x,y)</td> 
   <td>返回指定值的和</td> 
   <td>sum(x,y,…)</td> 
  </tr> 
  <tr> 
   <td>sumtotaltermfreq</td> 
   <td>返回所有<code>totaltermfreq</code>的和</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>termfreq</td> 
   <td>词出现的次数</td> 
   <td>termfreq(title,’solr’)</td> 
  </tr> 
  <tr> 
   <td>tf</td> 
   <td>词频</td> 
   <td>tf(text,’solr’)</td> 
  </tr> 
  <tr> 
   <td>top</td> 
   <td>功能类似于<code>ord</code></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>totaltermfreq</td> 
   <td>返回这个词在该字段出现的次数</td> 
   <td>ttf(title,’memory’)</td> 
  </tr> 
  <tr> 
   <td>and</td> 
   <td>返回true值当且仅当它的所有操作为true</td> 
   <td>and(not (exists (popularity)), exists (price))</td> 
  </tr> 
  <tr> 
   <td>or</td> 
   <td>返回true值当有一个操作为true</td> 
   <td>or(value1,value2)</td> 
  </tr> 
  <tr> 
   <td>xor</td> 
   <td>返回false值如果所有操作都为真</td> 
   <td>xor(field1,field2)</td> 
  </tr> 
  <tr> 
   <td>not</td> 
   <td>排除操作</td> 
   <td>not(exists(title))</td> 
  </tr> 
  <tr> 
   <td>exists</td> 
   <td>如果字段存在返回真</td> 
   <td>exists(title)</td> 
  </tr> 
  <tr> 
   <td>gt, gte, lt, lte, eq</td> 
   <td>比较函数</td> 
   <td>2 gt 1</td> 
  </tr> 
 </tbody> 
</table>

[Solr]: https://cwiki.apache.org/confluence/display/solr/Function+Queries