Solr函数查询

一. 函数查询(Function Query)

函数查询可以利用 numeric 域的值或者与域相关的某个特定的值的函数,来对文档进行评分。

1. 使用函数查询的方法

这里主要有三种方法可以使用函数查询,这三种方法都是通过 solr http 接口的。

1) 使用 FunctionQParserPlugin

即:q={!func}log(foo)

2) 使用 “val“ 内嵌方法

内嵌在正常的 solr 查询表达式中。即,将函数查询写在 q 这个参数中,这时候,我们使用 “val“ 将函数与其他的查询加以区别。

即:entryNm:make && _val_:ord(entryNm)

3) 使用 dismax 中的 bf 参数

使用明确为函数查询的参数,比如说 dismax 中的 bf(boost function)这个参数。

注意: bf 这个参数是可以接受多个函数查询的,它们之间用空格隔开,它们还可以带上权重。所以,当我们使用 bf 这个参数的时候,我们必须保证单个函数中是没有空格出现的,不然程序有可能会以为是两个函数。

例如: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 的值,这个域必须是 indexed 的,非 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

linear(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)

© 2025 Solr Community of China All Rights Reserved. 本站访客数人次 本站总访问量
Theme by hiero