OpenSearch：查詢測試

叢集部署成功後就可以開始搜尋體驗，召回引擎版在控制台中內建了“查詢測試”功能方便使用者查詢測試。並提供了各種搜尋子句配置，用戶端的查詢請求可以根據具體搜尋需求自行配置進行搜尋測試。

使用方法

1. 在召回引擎版控制台>【執行個體管理】>【查詢測試】頁面：在OpenSearch執行個體管理頁面的執行個體列表中，找到目標執行個體，單擊其操作列的查詢測試。

2. 點擊【查詢測試】選擇子句類型（SQL/HA3/RESTAPI查詢），支援使用者通過SQL子句、Ha3子句和RESTAPI文法進行搜尋，使用者需先選擇子句類型，點擊【搜尋】後，展示對應的搜尋結果，使用者可根據自己的需要添加對應的子句。

HA3查詢

查詢測試下拉框選擇【HA3查詢】，會出現對應的輸入項，query串和子句輸入，query語句屬於HA3查詢中的必選項，子句語句中的config語句與cluster語句同樣屬於查詢必選項，平台預設會添加，其他子句可根據召回需求自行添加。

單擊子句配置地區右側的 + 按鈕，可在下拉式功能表中選擇要添加的子句類型，包括 kvpairs clause、filter clause、pkfilter clause、aggregate clause、attribute clause、virtual_attribute clause、distinct clause、sort clause、layer clause 等。

ha3語句召回結果展示：

例如在 query 輸入框中輸入 id:'100532569311552725'，子句 config 預設填充 start:0,hit:10,format:json，cluster 預設為 general，單擊搜尋後，頁面展示完整查詢語句及結果統計（找到結果條數與耗時），並列出匹配文檔的各欄位值（如 id、fb_datetime、fb_boolean、fb_string 等）。右上方可通過顯示欄位數輸入框控制返回欄位數量，開啟顯示URL開關可查看請求 URL。

SQL查詢

查詢測試下拉框選擇【SQL查詢】，輸入查詢語句，query為必填項，輸入語句點擊【搜尋】。

kvpair 子句添加根據召回需求自行添加。

在左側導覽列單擊執行個體管理，進入查詢測試頁面。在 sql= 輸入框中輸入查詢語句，例如 select * from index_a where id = 7370577090061071286。

sql語句召回結果展示：

執行查詢後，結果地區頂部展示完整查詢字串（如 query=select * from index_a &&kvpair=format:full_json），下方輸出執行耗時（USE_TIME）和返回行數（ROW_COUNT），並以 TABLE INFO 表格展示召回資料。頁面右上方可通過顯示欄位數控制結果展示的列數（如設為 10），開啟顯示URL開關可查看完整請求地址，開啟源碼模式開關可查看原始返回內容。

RESTAPI查詢

查詢測試下拉框選擇「RESTAPI查詢」後，頁面上方提供索引表下拉選擇框，用於選擇目標索引表；左側為 JSON 格式的查詢語句輸入地區，右側為結果展示地區。在索引表下拉框中選擇目標索引表，在左側 JSON 輸入框中輸入查詢語句，單擊【搜尋】按鈕執行查詢

輸入RESTAPI查詢串點擊【搜尋】，右側會展示召回結果：

樣本中選擇索引表 index_odps，查詢結果以 XML 格式返回，命中 1 條記錄，包含 id、name、age、price、crate_data、get_marry 等欄位及對應值。

{
  "query": "index_id:12"
}

查詢文法

• SQL查詢語句；

• HA查詢語句；

• RESTAPI查詢語句；