isearch/docs/Quickstart.md

89 lines
3.0 KiB
Markdown
Raw Normal View History

2021-04-02 16:14:05 +08:00
为了省去配置机器环境的麻烦建议通过docker来运行demo容器在终端执行如下命令
```
// KEYWORD_CACHE_SIZE和HANPIN_CACHE_SIZE用于设置缓存的大小单位为M默认是100M
docker run --env KEYWORD_CACHE_SIZE=1024 --env HANPIN_CACHE_SIZE=1024 -d intelligentsearch/search_local:1.0
```
启动容器后,通过如下命令进入容器:
```
docker exec -it 容器id /bin/bash
```
容器id替换为上一步启动的容器对应的id
### 1. 查看项目配置文件
isearch应用的字段配置文件名称为app_field_define.txt通过以下指令查看配置文件内容
```
cat /usr/local/intelligentsearch/index_write/conf/app_field_define.txt
```
可以看到demo应用的appid为10001对应的字段为doc_id、title、content、author、weight、telephone、longitude、latitude。
### 2. 上报索引数据
执行如下命令进行测试数据的导入。
```
cd /usr/local/intelligentsearch/tools
./client_test send.json 106 127.0.0.1 11017
```
若屏幕显示如下信息,则表示数据导入成功:
```
send count == 1
recv: 27 bytes
server message: {"code":0}
```
可以通过修改send.json中的数据来导入更多的测试数据。
### 3. 测试搜索
首先我们分别以亚运会、金牌、公园进行搜索修改search.json文件
```
{"key":"亚运会", "appid":10001, "fields":"title"}
{"key":"金牌", "appid":10001, "fields":"title"}
{"key":"公园", "appid":10001, "fields":"title"}
```
执行如下命令进行数据的查询:
```
cd /usr/local/intelligentsearch/tools
./client_test search.json 101 127.0.0.1 12003
```
以下为公园的搜索结果:
```
{
"code": 0,
"count": 1,
"hlWord": ["公园"],
"result": [{
"doc_id": "12351",
"score": 11.689424985915906,
"title": "非洲特色动植物首次亮相北京市属公园 "
}]
}
```
接下来测试复杂的字段以及布尔搜索:
```
// title包含公园的记录
{"key":"title:公园", "appid":10001, "fields":"title"}
// title包含公园或者author是张三的记录
{"key":"title:公园 author:张三", "appid":10001, "fields":"title"}
// content字段包含京东并且author是张三的记录
{"key_and":"content:京东 author:张三", "appid":10001, "fields":"title"}
// content字段包含京东并且author不是张三的记录
{"key":"content:京东", "key_invert":"author:张三", "appid":10001, "fields":"title"}
```
接下来测试模糊匹配的情形:
```
{"key":"author:zs", "appid":10001,"fields":"title"}
{"key":"author:张", "appid":10001,"fields":"title"}
```
接下来测试范围查的情形:
```
// weight字段在21到24之间的记录
{"key":"weight:[21,24]", "appid":10001, "fields":"title"}
// weight字段在21到24之间的记录并且结果按照weight升序排列
{"key":"weight:[21,24]", "sort_type":"4", "sort_field":"weight", "appid":10001 ,"fields":"title"}
```
接下来测试地理位置查询的场景:
```
// 查询坐标点[116.50, 39.76]附近900米范围内的记录
{"key_and":"longitude:116.50 latitude:39.76 distance:0.9", "appid":10001, "fields":"title"}
```