查询测试

集群部署成功后就可以开始搜索体验，召回引擎版在控制台中内置了“查询测试”功能方便用户查询测试。并提供了各种搜索子句配置，客户端的查询请求可以根据具体搜索需求自行配置进行搜索测试。

使用方法

1. 在召回引擎版控制台>【实例管理】>【查询测试】页面：在开放搜索实例管理页面的实例列表中，找到目标实例，单击其操作列的查询测试。

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查询语句；