config部分可以指定查詢結果的起始位置、返回結果的數量、展現結果的格式、參與精排表達式文檔個數等。
語法說明
參數 | 類型 | 必需 | 取值范圍 | 默認值 | 描述 |
start | int | 否 | [0, 5000] | 0 | 從搜索結果中第start個文檔開始返回 |
hit | int | 否 | [0, 500] | 10 | 返回文檔的最大數量 |
format | string | 否 | json | 返回的文檔格式,有json、fulljson兩種格式可選。fulljson:比json類型多輸出一些節點,如variableValue、sortExprValues等。 | |
rerank_size | int | 否 | [0, 2000] | 200 | 設置單列參與精排的文檔個數 |
total_rank_size | int | 否 | - | - | 設置參與粗排的文檔個數 |
default_operator | string | 否 | 'AND' or 'OR' | AND | 指定在該次查詢中使用的默認query 操作符(注,僅獨享型實例支持該參數) |
注意事項
config子句為可選子句。
參數對之間使用逗號(,)分隔。
參數對內key、value采用冒號(:)分隔。
start+hit<=5000,超過5000會直接報錯無結果。(如有需要實現超過5000條數據的翻頁,可以通過scroll方法方法批量導出文檔后,自行實現分頁邏輯)
default_operator 參數僅供獨享型實例配置。
total_rank_size參數在SDK中配置方法,Java SDK:
config.addToCustomConfig("total_rank_size:200000");
、php SDK:$params->setCustomConfig('total_rank_size', 200000);
。代碼中查看排序明細:
方法:在config子句中添加參數:format:fulljson;
在返回結果中sortExprValues 就是文檔得分:
sortExprValues 是個數組,表示sort子句中排序字段的值,例:
sort=-price;-RANK
那么sortExprValues 就是[price,文檔得分]
如果不設置sort,默認就是文檔得分
示例
翻頁使用:每頁20個結果,分別獲取第一頁、第二頁結果;
#第一頁 config=start:0, hit:20, format:xml #第二頁 config=start:20, hit:20, format:xml
設置精排文檔數為1000;
config=start:0, hit:20, rerank_size:1000
減少要召回的文檔數;
config=start:0, hit:20, total_rank_size:100