Skip to content

(Piper) Searcher API

成文 edited this page May 6, 2023 · 16 revisions

1 Searcher API Base Url


[http:]xxxx:8080/alias


2 查询通用字段


参数字段 作用 示例 约束
fl 需要返回的字段 id,name store=true字段
count 返回条数 默认1 1<=count<=2000
start 起始位置 默认0 start>=0,start+count<=20000
sort 排序 sort=field_asc 或者 sort=field_desc,多值sort=field1_desc,field2_desc 若是地理查询按距离排序取第一个点的距离来排序
showquery 调试模式,进行分数和语句解释 true/false None
__stats 返回实例(集群)状态 true/false None

3 索引内容字段查询


示例 作用 约束
field=value 完全匹配检索 字段index需要为true
field=v1_v2 范围查询,表示查询field值为 大于v1 小于v2,默认是包含上下界,如需调整需要在xml配置文件配置 字段必须存储数值且index需要为true
field=11.0:32:0:10 地理坐标查询,lat:log:内环:外环,内环外环有单位如0m:10m,支持","语法,如field=11.0:32:0:10,12.0:31:0:10实现多点查询 特种查询非所有数据源都支持

注:以下所有参数属特殊定义,不是所有数据源都支持需要自行开发对应流控制实现部署到searcher.flow包下


4 特殊自定义条件查询


参数字段 作用 示例 约束
search_dsl 自定义查询语句 search_dsl=(field:value OR field2:value2) 原生lucene语法格式,仅支持solr,es数据源

5 聚合查询 facet与facet_ext特种参数


参数字段 作用 示例
facet 聚合参数,函数:返回名称:字段名 facet=term:agg_field:fieldname,sum:sum_fields_alias:field1,可自定义传入如,topHits:0:(DEF(sort=id;size=1;...))
facet_ext 聚合扩展参数,size 返回的分组数,start起始位置 order 聚合排序字段 facet_ext=size:10,order:field desc

6 查询中的特种参数


参数字段 作用 示例
request_handler 查询处理器参数 request_handler=/select

7 查询例子


存储类型 查询示例 解释
Vearch ip:8080/face_vearch?id=7ef3d1feeb2d11edaf000242ac110003&__storeid=1683216000&showquery=true __storeid为按时间序列生成的表的后缀ID