solr查詢語法詳解
原文部落格:http://www.cnblogs.com/zhangweizhong/p/5056884.html
一.基本查詢
q 查詢的關鍵字,此引數最為重要,例如,q=id:1,預設為q=*:*,
fl 指定返回哪些欄位,用逗號或空格分隔,注意:欄位區分大小寫,例如,fl= id,title,sort
start 返回結果的第幾條記錄開始,一般分頁用,預設0開始
rows 指定返回結果最多有多少條記錄,預設值為 10,配合start實現分頁
sort 排序方式,例如id desc 表示按照 “id” 降序
wt (writer type) 指定輸出格式,有 xml, json, php等
fq (filter query) 過慮查詢,提供一個可選的篩選器查詢。返回在q查詢符合結果中同時符合的fq條件的查詢結果,例如:q=id:1&fq=sort:[1 TO 5],找關鍵字id為1 的,並且sort是1到5之間的。
df 預設的查詢欄位,一般預設指定。
qt (query type) 指定那個型別來處理查詢請求,一般不用指定,預設是standard。
indent 返回的結果是否縮排,預設關閉,用 indent=true|on 開啟,一般除錯json,php,phps,ruby輸出才有必要用這個引數。
version 查詢語法的版本,建議不使用它,由伺服器指定預設值。
二. Solr的檢索運算子
“:” 指定欄位查指定值,如返回所有值*:*
“?” 表示單個任意字元的通配
“*” 表示多個任意字元的通配(不能在檢索的項開始使用*或者?符號)
“~” 表示模糊檢索,如檢索拼寫類似於”roam”的項這樣寫:roam~將找到形如foam和roams的單詞;roam~0.8,檢索返回相似度在0.8以上的記錄。
AND、|| 布林操作符
OR、&& 布林操作符
NOT、!、- (排除操作符不能單獨與項使用構成查詢)
“+” 存在操作符,要求符號”+”後的項必須在文件相應的域中存在²
( ) 用於構成子查詢
[] 包含範圍檢索,如檢索某時間段記錄,包含頭尾,date:[201507 TO 201510]
{} 不包含範圍檢索,如檢索某時間段記錄,不包含頭尾date:{201507 TO 201510}
三. 高亮
h1 是否高亮,hl=true,表示採用高亮
hl.fl 設定高亮顯示的欄位,用空格或逗號隔開的欄位列表。要啟用某個欄位的highlight功能,就得保證該欄位在schema中是stored。如果該引數未被給出,那麼就會高亮預設欄位 standard handler會用df引數,dismax欄位用qf引數。你可以使用星號去方便的高亮所有欄位。如果你使用了萬用字元,那麼要考慮啟用hl.requiredFieldMatch選項。
hl.requireFieldMatch 如果置為true,除非用hl.fl指定了該欄位,查詢結果才會被高亮。它的預設值是false。
hl.usePhraseHighlighter 如果一個查詢中含有短語(引號框起來的)那麼會保證一定要完全匹配短語的才會被高亮。
hl.highlightMultiTerm 如果使用萬用字元和模糊搜尋,那麼會確保與萬用字元匹配的term會高亮。預設為false,同時hl.usePhraseHighlighter要為true。
hl.fragsize 返回的最大字元數。預設是100.如果為0,那麼該欄位不會被fragmented且整個欄位的值會被返回。
四. 分組
這是facet的官方wiki,裡面有facet各個引數的詳細說明。所以這裡只說一些常用的。
Facet是Solr的核心搜尋功能,主要是導航(Guided Navigation)、引數化查詢(Paramatic Search)。Facet的主要好處是在搜尋的同時,可以按照Facet條件進行分組統計,給出導航資訊,改善搜尋體驗。
Facet主要分為:Field Facet 和 Date Facet 兩大類
1. Field Facet
facet 引數欄位必須被索引
facet=on 或 facet=true
facet.field 分組的欄位
facet.prefix 表示Facet欄位字首
facet.limit Facet欄位返回條數
facet.offict 開始條數,偏移量,它與facet.limit配合使用可以達到分頁的效果
facet.mincount Facet欄位最小count,預設為0
facet.missing 如果為on或true,那麼將統計那些Facet欄位值為null的記錄
facet.sort 表示 Facet 欄位值以哪種順序返回 .格式為 true(count)|false(index,lex),true(count) 表示按照 count 值從大到小排列,false(index,lex) 表示按照欄位值的自然順序 (字母 , 數字的順序 ) 排列 . 預設情況下為 true(count)
2. Date Facet
對日期型別的欄位進行 Facet. Solr 為日期欄位提供了更為方便的查詢統計方式 .注意 , Date Facet的欄位型別必須是 DateField( 或其子型別 ). 需要注意的是 , 使用 Date Facet 時 , 欄位名 , 起始時間 , 結束時間 , 時間間隔這 4 個引數都必須提供 .
facet.date 該引數表示需要進行 Date Facet 的欄位名 , 與 facet.field 一樣 , 該引數可以被設定多次 , 表示對多個欄位進行 Date Facet.
facet.date.start 起始時間 , 時間的一般格式為 ” 2015-12-31T23:59:59Z”, 另外可以使用 ”NOW”,”YEAR”,”MONTH” 等等 ,
facet.date.end 結束時間
facet.date.gap 時間間隔,如果 start 為 2015-1-1,end 為 2016-1-1,gap 設定為 ”+1MONTH” 表示間隔1 個月 , 那麼將會把這段時間劃分為 12 個間隔段 .
facet.date.hardend 表示 gap 迭代到 end 時,還剩餘的一部分時間段,是否繼續去下一個間隔. 取值可以為 true|false, 預設為 false.
例 start 為 2015-1-1,end 為 2015-12-21,gap 為 ”+1MONTH”, 如果hardend 為 false,則,最後一個時間段為 2015-12-1 至 2016-1-1; 反之,如果 hardend 為 true,則,最後一個時間段為 2015-12-1 至 2015-12-21.
注意:Facet的欄位必須被索引,無需分詞,無需儲存。無需分詞是因為該欄位的值代表了一個整體概念,無需儲存是因為一般而言使用者所關心的並不是該欄位的具體值,而是作為對查詢結果進行分組的一種手段,給出相關的分組資訊,從而改善搜尋體驗。