處理搜尋結果

查詢呼叫正常完成時，會以 SearchResults 物件的形式傳回結果。結果物件會告知您在索引中找到的相符文件數量，以及傳回的相符文件數量，同時也會提供相符 ScoredDocuments 的清單。這份清單通常包含所有找到相符文件的一部分，因為搜尋會在每次呼叫時傳回限定數量的文件。您可以使用位移或游標來擷取所有相符文件 (一次一個子集)。

結果

def query_results(index, query_string):
    result = index.search(query_string)
    total_matches = result.number_found
    list_of_docs = result.results
    number_of_docs_returned = len(list_of_docs)
    return total_matches, list_of_docs, number_of_docs_returned

視 limit 查詢選項的值而定，結果中傳回的相符文件數量可能會小於找到的數量。請注意，如果找到數量的準確率低於找到的數量，則找到的數量為預估值。無論您如何設定搜尋選項，search() 呼叫最多只會找到 10,000 個相符的文件。

如果找到的文件數量比傳回的文件多，而您想要擷取所有文件，則須如下所述使用位移或游標來重複執行搜尋。

計分文件

搜尋結果會包含符合查詢的 ScoredDocuments 清單。您可以疊代處理清單來依序處理每個文件：

for scored_document in results:
        print(scored_document)

根據預設，計分文件包含已編入索引之原始文件的所有欄位。如果查詢選項已指定 returned_fields，則只有這些欄位會顯示在文件的 fields 屬性中。如果您已指定 returned_expressions 或 snippeted_fields 來建立任何運算欄位，則這些欄位會個別顯示在文件的 expressions 屬性中。

使用位移

如果搜尋找到的文件數量比一次可傳回的文件數量多，請使用位移將相符文件清單編入索引。例如，預設查詢上限為 20 個文件。在第一次執行搜尋 (使用位移 0) 並擷取前 20 個文件後，將位移設為 20 並再次執行相同的搜尋，即可擷取後續的 20 個文件。持續重複執行搜尋，每次均以傳回的文件數量對位移進行遞增：

def query_offset(index, query_string):
    offset = 0

    while True:
        # Build the query using the current offset.
        options = search.QueryOptions(offset=offset)
        query = search.Query(query_string=query_string, options=options)

        # Get the results
        results = index.search(query)

        number_retrieved = len(results.results)
        if number_retrieved == 0:
            break

        # Add the number of documents found to the offset, so that the next
        # iteration will grab the next page of documents.
        offset += number_retrieved

        # Process the matched documents
        for document in results:
            print(document)

疊代處理非常大型的結果集時，使用位移可能會效率不彰。

使用游標

您也可以使用游標來擷取某個子範圍的結果。如果您想要以連續頁面呈現搜尋結果，並且確保在查詢之間修改索引時仍不會略過任何文件，那麼游標會是很實用的方式。疊代處理非常大型的結果集時，使用游標也可提高效率。

如要使用游標，您必須建立初始游標，並將該游標包含在查詢選項中。游標有兩種形式：「根據查詢」以及「根據結果」。「根據查詢」的游標會將個別的游標關聯至搜尋呼叫所傳回的結果物件。「根據結果」的游標會將游標關聯至結果中的每個計分文件。

使用根據查詢的游標

根據預設，新建構的游標為根據查詢的游標。這個游標會保存搜尋結果傳回的最後一個文件所在位置，這個位置會隨著每次搜尋進行更新。如要列舉索引中的所有相符文件，請執行相同的搜尋，直到結果傳回空值游標為止：

def query_cursor(index, query_string):
    cursor = search.Cursor()

    while cursor:
        # Build the query using the cursor.
        options = search.QueryOptions(cursor=cursor)
        query = search.Query(query_string=query_string, options=options)

        # Get the results and the next cursor
        results = index.search(query)
        cursor = results.cursor

        for document in results:
            print(document)

使用根據結果的游標

如要建立根據結果的游標，您必須在建立初始游標時，將游標 per_result 屬性設定為 True。搜尋傳回結果時，每個文件都會有與該結果建立關聯的游標。您可以使用該游標，指定新搜尋時含有以特定文件開始的結果。請注意，當您將根據結果的游標傳送到搜尋時，不會有任何根據查詢的游標與結果本身相關聯；result.getCursor() 會傳回空值，這樣您就無法使用這種方式來測試是否已擷取所有相符項目。

def query_per_document_cursor(index, query_string):
    cursor = search.Cursor(per_result=True)

    # Build the query using the cursor.
    options = search.QueryOptions(cursor=cursor)
    query = search.Query(query_string=query_string, options=options)

    # Get the results.
    results = index.search(query)

    document_cursor = None
    for document in results:
        # discover some document of interest and grab its cursor, for this
        # sample we'll just use the first document.
        document_cursor = document.cursor
        break

    # Start the next search from the document of interest.
    if document_cursor is None:
        return

    options = search.QueryOptions(cursor=document_cursor)
    query = search.Query(query_string=query_string, options=options)
    results = index.search(query)

    for document in results:
        print(document)

儲存和還原游標

您可將游標序列化為網頁安全字串並加以儲存，然後還原以供日後使用：

def saving_and_restoring_cursor(cursor):
    # Convert the cursor to a web-safe string.
    cursor_string = cursor.web_safe_string
    # Restore the cursor from a web-safe string.
    cursor = search.Cursor(web_safe_string=cursor_string)