1. 程式人生 > >solr查詢語法詳解

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的欄位必須被索引,無需分詞,無需儲存。無需分詞是因為該欄位的值代表了一個整體概念,無需儲存是因為一般而言使用者所關心的並不是該欄位的具體值,而是作為對查詢結果進行分組的一種手段,給出相關的分組資訊,從而改善搜尋體驗。