当前位置：首页 > news >正文

在elasticsearch8.3中安装elasticsearch-analysis-ik中文分词插件

news 2025/9/12 19:10:39

title: 在elasticsearch8.3中安装elasticsearch-analysis-ik中文分词插件
date: 2022-08-28 00:00:00
tags:

ElasticSearch
elasticsearch-analysis-ik
中文分词插件
categories:
ElasticSearch

安装

手动下载

在官方发布页面下载安装包 elasticsearch-analysis-ik-[版本].zip，其版本与你安装的ES要相同。
执行命令 ~/elasticsearch-8.3.3/plugins/analysis-ik 创建ik插件存储目录，将上面的文件解压后放到analysis-ik目录内：

tianmx@mydebian:[~/elasticsearch-8.3.3/plugins/analysis-ik]: ll
总用量 1.5M
drwxr-xr-x 3 tianmx tianmx 4.0K  8月 28 23:09 ./
drwxr-xr-x 5 tianmx tianmx 4.0K  8月 28 23:08 ../
-rw-r--r-- 1 tianmx tianmx 258K  9月 29  2020 commons-codec-1.9.jar
-rw-r--r-- 1 tianmx tianmx  61K  9月 13  2020 commons-logging-1.2.jar
drwxr-xr-x 2 tianmx tianmx 4.0K  8月 28 17:05 config/
-rw-r--r-- 1 tianmx tianmx  54K  8月 28 22:56 elasticsearch-analysis-ik-8.3.3.jar
-rw-r--r-- 1 tianmx tianmx 720K  9月 29  2020 httpclient-4.5.2.jar
-rw-r--r-- 1 tianmx tianmx 320K  9月 29  2020 httpcore-4.4.4.jar
-rw-r--r-- 1 tianmx tianmx 1.8K  8月 28 22:56 plugin-descriptor.properties
-rw-r--r-- 1 tianmx tianmx  125  8月 28 22:56 plugin-security.policy

远程安装

使用 elasticsearch-plugin 安装（从 v5.5.1 版本开始支持）
执行命令 ./bin/elasticsearch-plugin install https://github.com/medcl/elasticsearch-analysis-ik/releases/download/[版本]/elasticsearch-analysis-ik-[版本].zip 将自动下载并解压到插件目录。
下载插件的地址需从IK官方Github发布页面上复制，注意版本号与你安装的ES一致。

手动编译

一般来说官方会适时发布与新版本相匹配包，但有时也并不会那么及时，在写本篇文章时并没有8.3.3的版本。另外如果你想对源码作一些改造调整的话，还是自己编译最方便。

编译环境
- IntelliJ IDEA 2022.2.1（非必需，你可以用文本编辑器）
- Apache Maven 3.8.1
- OpenJDK 17
从Github上下载最新源码，这里我们取master分支的代码。
需要对源码进行如下调整才能顺利编译：
1. 打开 pom.xml 文件将 <elasticsearch.version>7.16.0</elasticsearch.version> 修改为 <elasticsearch.version>8.3.3</elasticsearch.version>。
2. 将文中 <maven.compiler.target>1.8</maven.compiler.target> 修改为 <maven.compiler.target>17</maven.compiler.target>。
3. 将文中 maven-javadoc-plugin 插件配置整个删除掉。
4. 打开 IkAnalyzerProvider.java 类修复构造方法报错问题，也就是将 super(indexSettings, name, settings); 改为 super(name, settings); 即可。
在IDEA的Maven窗口中找到Profiles节点，然后选中release，点击左上角刷新按钮，如果想跳过单元测试可点击 Skip Tests 按钮。按住Ctrl键并用鼠标依次单击选中clean和package，最后单击工具类绿色播放按钮。
（可选项）如果你想通过命令行执行maven进行编译，可以执行 mvn -DskipTests=true clean package -P release。
如果一切顺利你应该能够在编译目录 target/releases/elasticsearch-analysis-ik-8.3.3.zip 中看到打好的zip包。
接下来按上面介绍的手动下载章节来完成安装工作。

测试

注意：插件安装完后要重启ES。

重启ES后执行如下命令查看插件是否安装成功

tianmx@mydebian:[~/elasticsearch-8.3.3]: ./bin/elasticsearch-plugin list
analysis-icu
analysis-ik
analysis-smartcn

如果你已经安装好了Kibana，那么可以进入 http://192.168.0.110:5601/app/dev_tools#/console 页面来测试一下，随便找个索引就可以发送请求测试。
ik_smart分词器: 会做最粗粒度的拆分，适合 Phrase 查询。

GET metrics-endpoint.metadata_current_default/_analyze
{"text": "中华人民共和国MN","tokenizer": "ik_smart"
}{"tokens": [{"token": "中华人民共和国","start_offset": 0,"end_offset": 7,"type": "CN_WORD","position": 0},{"token": "mn","start_offset": 7,"end_offset": 9,"type": "ENGLISH","position": 1}]
}

ik_max_word分词器: 会将文本做最细粒度的拆分，会穷尽各种可能的组合，适合 Term Query。

GET metrics-endpoint.metadata_current_default/_analyze
{"text": "中华人民共和国MN","tokenizer": "ik_max_word"
}{"tokens": [{"token": "中华人民共和国","start_offset": 0,"end_offset": 7,"type": "CN_WORD","position": 0},{"token": "中华人民","start_offset": 0,"end_offset": 4,"type": "CN_WORD","position": 1},{"token": "中华","start_offset": 0,"end_offset": 2,"type": "CN_WORD","position": 2},{"token": "华人","start_offset": 1,"end_offset": 3,"type": "CN_WORD","position": 3},{"token": "人民共和国","start_offset": 2,"end_offset": 7,"type": "CN_WORD","position": 4},{"token": "人民","start_offset": 2,"end_offset": 4,"type": "CN_WORD","position": 5},{"token": "共和国","start_offset": 4,"end_offset": 7,"type": "CN_WORD","position": 6},{"token": "共和","start_offset": 4,"end_offset": 6,"type": "CN_WORD","position": 7},{"token": "国","start_offset": 6,"end_offset": 7,"type": "CN_CHAR","position": 8},{"token": "mn","start_offset": 7,"end_offset": 9,"type": "ENGLISH","position": 9}]
}