查詢呼叫正常完成時,會以 SearchResults
物件的形式傳回結果。結果物件會告知您在索引中找到的相符文件數量,以及傳回的相符文件數量,同時也會提供相符 ScoredDocuments
的清單。這份清單通常包含所有找到相符文件的一部分,因為搜尋會在每次呼叫時傳回限定數量的文件。您可以使用位移或游標來擷取所有相符文件 (一次一個子集)。
結果
視 limit
查詢選項的值而定,結果中傳回的相符文件數量可能會小於找到的數量。請注意,如果找到數量的準確率低於找到的數量,則找到的數量為預估值。無論如何設定搜尋選項,search()
呼叫最多只會找到 10,000 份相符文件。
如果找到的文件數量比傳回的文件多,而您想要擷取所有文件,則須如下所述使用位移或游標來重複執行搜尋。
計分文件
搜尋結果會包含符合查詢的 ScoredDocuments
清單。您可以疊代處理清單來依序處理每個文件:
根據預設,計分文件包含已編入索引之原始文件的所有欄位。如果查詢選項已指定 returned_fields
,則只有這些欄位會顯示在文件的 fields 屬性中。如果您已指定 returned_expressions
或 snippeted_fields
來建立任何運算欄位,則這些欄位會個別顯示在文件的 expressions 屬性中。
使用位移
如果搜尋找到的文件數量比一次可傳回的文件數量多,請使用位移將相符文件清單編入索引。例如,預設查詢上限為 20 個文件。在第一次執行搜尋 (使用位移 0) 並擷取前 20 個文件後,將位移設為 20 並再次執行相同的搜尋,即可擷取後續的 20 個文件。持續重複執行搜尋,每次均以傳回的文件數量對位移進行遞增:
疊代處理非常大型的結果集時,使用位移可能會效率不彰。
使用游標
您也可以使用游標來擷取某個子範圍的結果。如果您想要以連續頁面呈現搜尋結果,並且確保在查詢之間修改索引時仍不會略過任何文件,那麼游標會是很實用的方式。疊代處理非常大型的結果集時,使用游標也可提高效率。
如要使用游標,您必須建立初始游標,並將該游標包含在查詢選項中。游標有兩種形式:「根據查詢」以及「根據結果」。「根據查詢」的游標會將個別的游標關聯至搜尋呼叫所傳回的結果物件。「根據結果」的游標會將游標關聯至結果中的每個計分文件。
使用根據查詢的游標
根據預設,新建構的游標為根據查詢的游標。這個游標會保存搜尋結果傳回的最後一個文件所在位置,這個位置會隨著每次搜尋進行更新。如要列舉索引中的所有相符文件,請執行相同的搜尋,直到結果傳回空值游標為止:
使用根據結果的游標
如要建立根據結果的游標,您必須在建立初始游標時,將游標 per_result 屬性設定為 True。搜尋傳回結果時,每個文件都會有與該結果建立關聯的游標。您可以使用該游標,指定新搜尋時含有以特定文件開始的結果。請注意,當您將根據結果的游標傳送到搜尋時,不會有任何根據查詢的游標與結果本身相關聯;result.getCursor() 會傳回空值,這樣您就無法使用這種方式來測試是否已擷取所有相符項目。
儲存和還原游標
您可將游標序列化為網頁安全字串並加以儲存,然後還原以供日後使用: