作用
通過函式查詢讓我們可以利用 numeric域的值或者與域相關的的某個特定的值的函式,來對文件進行評分。
如何使用
這裡主要有兩種方法可以使用函式查詢,這兩種方法都是通過solr http 介面的:
1、內嵌在正常的solr查詢表示式中。即,將函式查詢寫在 q這個引數中,這時候,我們使用_val_將函式與其他的查詢加以區別。至於具體怎樣使用,請讀者留意下面的例子。
2、使用明確為函式查詢的引數,比如說dismax中的bf(boost function)這個引數。 注意:bf這個引數是可以接受多個函式查詢的,它們之間用空格隔開,它們還可以帶上權重。所以,當我們使用bf這個引數的時候,我們必須保證單個函式中是沒有空格出現的,不然程式有可能會以為是兩個函式。
例如:q=dismax&bf=ord(popularity)^0.5 recip(rord(price),1,1000,1000)^0.3
函式格式
目前,function query 並不支援 a+b 這樣的形式,我們得把它寫成一個方法形式,這就是 sum(a,b)
函式詳解
1、constant:支援有小數點的常量,
例如,1.5,查詢表示式就是:_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,如果 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)