注意
Foundry IQ(Azure AI 搜尋服務)提供直接的索引與查詢 API,並搭配高階知識來源與知識庫 API 用於受控檢索。 使用 Azure 入口網站、REST API 或 Azure SDK 來設定這些功能,或將代理連線到 Microsoft Foundry 入口網站 中的知識庫。
在 Foundry IQ (Azure AI 搜尋服務) 中,$orderby 參數指定搜尋結果的自訂排序順序。 本文說明$orderby的 OData 語法,並提供範例。
欄位路徑的建構與常數詳述於 Foundry IQ 中的 OData 語言概述。 如需排序行為的詳細資訊,請參閱 排序結果。
語法
$orderby參數接受最多 32 個排序子句的逗號分隔清單。 排序子句的語法由下列 EBNF(扩展的巴科斯-瑙尔形式)描述:
order_by_clause ::= (field_path | sortable_function) ('asc' | 'desc')?
sortable_function ::= geo_distance_call | 'search.score()'
我們也提供互動式語法圖表:
注意
完整的 EBNF 請參閱 Foundry IQ 的 OData 表達式語法參考。
每個子句都有排序準則,可以選擇性地後面接著排序方向(asc 表示遞增或 desc 表示遞減)。 如果您未指定方向,則預設值為遞增。 如果欄位中有 Null 值,當排序為 asc 時,Null 值會先出現;當排序為 desc 時,Null 值會最後出現。
排序準則可以是欄位的路徑 sortable ,或者是對函式 geo.distance 或 search.score 的呼叫。
對於字串欄位,將會使用預設 ASCII 排序順序 和預設 Unicode 排序順序 。 根據預設,排序會區分大小寫,但您可以使用 正規化程式 在排序之前預先處理文字,以變更此行為。 您也可以使用 asciifolding 正規化工具,將非 ASCII 字元轉換成其 ASCII 對等項(如果存在)。
如果多個檔具有相同的排序準則,且 search.score 函式未使用(例如,如果您依數值 Rating 欄位排序,而三份檔都有 4 的評等),則系結會依遞減順序依檔分數中斷。 當檔分數相同時(例如,當要求中沒有指定全文搜索查詢時),則系結檔的相對順序不確定。
您可以指定多個排序準則。 表達式的順序會決定最終的排序順序。 例如,若要依分數排序遞減,後面接著 Rating,語法會是 $orderby=search.score() desc,Rating desc。
geo.distance 中使用 $orderby 時,其套用的欄位必須是 Edm.GeographyPoint 類型,而且也必須是 sortable。
search.score的語法在$orderby中為search.score()。 函式 search.score 不會採用任何參數。
範例
依基底費率遞增排序酒店:
$orderby=BaseRate asc
依評等遞減排序酒店,然後依基底費率遞增(請記住,遞增是預設值):
$orderby=Rating desc,BaseRate
將旅館依照評分由高至低排序,然後依照距離指定座標由近至遠排序。
$orderby=Rating desc,geo.distance(Location, geography'POINT(-122.131577 47.678581)') asc
依照 search.score 和 rating 的遞減順序排序酒店,然後再依照到指定座標的距離進行遞增排序。 在具有相同相關性分數和評等的兩家酒店之間,最接近的旅館會先列出:
$orderby=search.score() desc,Rating desc,geo.distance(Location, geography'POINT(-122.131577 47.678581)') asc