elasticsearch hanlp插件远程词典配置
- 背景
- 远程词典配置
- 新增远程词典文件
- 修改hanlp-remote.xml
- 自动加载词典
- 远程词典测试
背景
在使用elasticsearch的过程中，总会遇到与分词相关的需求，这里将针对常用的elasticsearch hanlp（后面统称为 es hanlp）分词插件进行讲解演示配置自定义业务字典，提高es hanlp分词的准确性，同时也提高查询效率。关于es hanlp通过更改关键词文件配置自定义词典的内容可以参考文章：https://developer.aliyun.com/article/1163240，本文主要是讲述另外一种自定义词典内容的操作，配置远程词典。
远程词典配置
新增远程词典文件
es hanlp关于远程词典的文件配置方式参考官方文档即可，文档地址：https://github.com/KennFalcon/elasticsearch-analysis-hanlp/tree/master，这里我把远程词典文件放在我们的腾讯云上面，主要是因为es hanlp 在加载远程词典文件时需要通过response header判断Last-Modified和 ETag来确定远程文件是否有变动，进而决定是否需要加载更新；而腾讯云返回的文件是直接带有Last-Modified和 ETag，这里可以看一下我的文件响应的response
符合官方文档要求的远程词典文件返回两个头部(header)，一个是 Last-Modified，一个是 ETag
说明：这里说明一下，如果这两个属性都没有变化的话，es hanlp插件是不会热更新关键词的；
另外，如果大家想要使用腾讯云COS作为远程词典文件存放位置的话，需要注意必须要用文件的原始请求地址，不能用有CDN缓存的地址，这样才能达到1分钟热更新的目的。比如
http://存储桶名.cos.ap-beijing.myqcloud.com/ei-dongao/mywords.txt
远程词典文件准备好之后就可以修改es hanlp 远程配置文件hanlp-remote.xml了
修改hanlp-remote.xml
找到hanlp-remote.xml配置文件路径ES_HOME/config/analysis-hanlp
修改hanlp-remote.xml，增加远程词典配置
这里配置好远程词典路径之后需要重启es，因为改动了配置文件嘛，后续更改远程配置文件的内容时就无需重启es了，因为你没有改动es的配置文件。
自动加载词典
配置完成远程词典内容后，无需重启es，等待1分钟后，词典自动加载。
[2023-04-24T13:29:16,636][INFO ][c.h.d.ExtMonitor ] [ei-test-es-node190] hanlp custom dictionary isn't modified, so no need reload
[2023-04-24T13:29:17,163][INFO ][c.h.d.RemoteMonitor ] [ei-test-es-node190] load hanlp remote custom dict path: http://存储桶名.cos.ap-beijing.myqcloud.com/ei-dongao/mywords.txt
[2023-04-24T13:29:17,623][INFO ][c.h.d.RemoteMonitor ] [ei-test-es-node190] finish load hanlp remote custom dict path: http://存储桶名.cos.ap-beijing.myqcloud.com/ei-dongao/mywords.txt
比如我在远程词典中增加关键词
腾讯云文件管理
加载完成之后我们可以开始测试是否生效。
注：多台es服务器配置时，需保证指向相同的远程词典路径，保证加载关键词文件的一致
远程词典测试
在远程词典测试之前，我们需要对我们的索引开启远程词典，这需要配置自定义分词，并开启远程词典加载开关，es hanlp 自定义分词配置参考博文：https://developer.aliyun.com/article/1163285
1.当我们使用hanlp默认词典配置的时候我们测试
POST _analyze
{
"text": "初级会计指南在这里",
"analyzer": "hanlp"
}
返回结果是
{
"tokens" : [
{
"token" : "初级",
"start_offset" : 0,
"end_offset" : 2,
"type" : "b",
"position" : 0
},
{
"token" : "会计",
"start_offset" : 2,
"end_offset" : 4,
"type" : "nnt",
"position" : 1
},
{
"token" : "指南",
"start_offset" : 4,
"end_offset" : 6,
"type" : "n",
"position" : 2
},
{
"token" : "在",
"start_offset" : 6,
"end_offset" : 7,
"type" : "p",
"position" : 3
},
{
"token" : "这里",
"start_offset" : 7,
"end_offset" : 9,
"type" : "rzs",
"position" : 4
}
]
}
2.我们使用自定义分词配置，开启远程词典
PUT test
{
"settings": {
"analysis": {
"analyzer": {
"hanlp_dongao": {
"tokenizer": "hanlp_analyzer"
}
},
"tokenizer": {
"hanlp_analyzer": {
"type": "hanlp",
"enable_stop_dictionary": true,
"enable_custom_config":true,
"enable_remote_dict":true
}
}
}
}
}
然后配置关键词
初级会计
等待远程词典加载完成后再次用开启了远程词典的索引测试
加载完成之后再次验证
POST test/_analyze
{
"text": "初级会计指南在这里",
"analyzer": "hanlp_dongao"
}
分词结果
{
"tokens" : [
{
"token" : "初级会计",
"start_offset" : 0,
"end_offset" : 4,
"type" : "n",
"position" : 0
},
{
"token" : "指南",
"start_offset" : 4,
"end_offset" : 6,
"type" : "n",
"position" : 1
}
]
}
可以看到已经将【初级会计】分成一个词了。
这里有一点需要说明，新增加关键词的话，热加载完成之后es分词就可以按照增加的关键词进行分词，但是删除关键词的话，还是会按之前增加的关键词进行分词，可能是es hanlp插件有缓存机制，也可能是插件版本的问题，我用的是匹配es版本6.7.1的hanlp插件，最新的版本可能不会存在这个问题，但是鉴于升级es改动较大，为了不影响业务只能采用当下版本对应的hanlp插件。这一点在使用es hanlp插件时需要考虑在内。
