本文为您介绍如何在控制台进行搜索测试操作。
功能概述
当数据上传成功后就可以开始搜索体验,我们在控制台中内置了“搜索测试”页面方便用户进行搜索测试,主要包含查询子句和查询参数。客户端的查询请求可以根据具体搜索需求自行配置进行搜索测试(详情请参见API概览及SDK简介)。以控制台中搜索测试页面为例,通过单击子句或参数后的“+”按钮,在弹出的下拉框中选择添加需要的查询子句或参数,再填写对应查询子句或参数内容,最后单击“搜索”按钮进行搜索效果测试。
操作步骤
-
登录开放搜索控制台,切换到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(数据列表)等字段。
业务排序策略使用Cava排序函数时,排序明细不会显示Cava的排序算法,需在Cava脚本中输出算法的trace,请参见OpsDoc。