OpenSearch：搜尋測試

功能概述

當資料上傳成功後就可以開始搜尋體驗，我們在控制台中內建了“搜尋測試”頁面方便使用者進行搜尋測試，主要包含查詢子句和查詢參數。用戶端的查詢請求可以根據具體搜尋需求自行配置進行搜尋測試（詳情請參見API概覽及SDK簡介）。以控制台中搜尋測試頁面為例，通過單擊子句或參數後的“+”按鈕，在彈出的下拉框中選擇添加需要的查詢子句或參數，再填寫對應查詢子句或參數內容，最後單擊“搜尋”按鈕進行搜尋效果測試。

操作步驟

1. 登入OpenSearch控制台，切換到OpenSearch-高效能檢索版，在功能擴充下進入搜尋測試頁面進行搜尋測試。

• OpenSearch原生查詢。

例如，在 query 子句中輸入 id:'1'，config 子句設定為 start:0,hit:10,format:fulljson，單擊搜尋後返回結果顯示找到 1 條記錄、耗時 26.737ms、耗費 LCU 0.294。

子句說明：查詢子句-query子句、過濾子句-filter子句、排序子句-sort子句、打散子句-distinct子句、統計子句-aggregate子句、自訂子句-kvpair子句、翻頁子句-config子句。

參數介紹：查詢相關參數請參見搜尋處理。

• SQL查詢。

SQL文法請參見SQL支援。

動態參數（dynamic_params ）配置請參見動態參數。

SQL查詢介面提供SQL輸入框，使用者可輸入SQL語句（如 SELECT * FROM table_name WHERE id='1'），並可配置動態參數（dynamic_params），單擊搜尋後頁面下方返回查詢結果及耗時資訊。

頁面功能介紹

原生查詢方式

• 添加查詢子句。

單擊參數行的+按鈕，在彈出的下拉式功能表中選擇要添加的子句類型，包括過濾子句 - filter、排序子句 - sort、打散子句 - distinct、統計子句 - aggregate、自訂子句 - kvpairs和配置子句 - config。

• 添加查詢參數。

單擊參數行的+按鈕，在下拉式功能表中選擇需要添加的參數，可選項包括：展示欄位（fetch_fields）、查詢分析（qp）、查詢策略（search_strategy）、粗排運算式（first_rank_name）、精排運算式（second_rank_name）。

• 顯示查詢URL：此處會顯示編碼後的查詢請求串。

樣本中，query 子句值為 default:'1'，config 子句值為 start:0,hit:10,format:fulljson，頁面底部產生對應的編碼後查詢請求 URL。

• 顯示排序明細：一般用於查看排序運算式的算分詳情。

排序詳細資料區域分為FirstRank和SecondRank兩個階段，逐行列出各expression運算式（如static_bm25()、normalize(sold_num)、query_match_ratio、field_match_ratio等）及其對應result值，並顯示最終排序公式（如0.6*static_bm25()+0.4*normalize(sold_num)）的綜合得分。

• 源碼模式：當使用者config中的format參數配置了fulljson，同時有aggregate子句，可以通過開啟源碼模式，查看aggregate子句中的facet統計結果。

例如，設定 config 子句為 start:0,hit:0,format:fulljson，設定 aggregate 子句為 group_key:is_promotion,agg_fun:sum(is_promotion)，開啟源碼模式後，JSON 響應中 facet 數組返回彙總統計對象，其 items 數組中每個元素包含 sum、value 和 key 欄位，分別表示彙總計算值、統計值和分組鍵名。

SQL查詢方式

• 源碼模式：可以通過開啟源碼模式，擷取查詢結果不同類型的結果（JSON）。

在查詢結果頁面右上方開啟源碼模式開關後，返回的JSON結果中包含searchtime（查詢耗時）、compute_cost（計算消耗）、num（結果數量）、items（資料列表）等欄位。