solr Query參數有哪些

146次閱讀

共計 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)