es之ik分词器插件的安装和使用

ik 分词器安装

	# 进入 es 集群的 es1 节点容器内部
	docker exec -it es1 bash
	
	cd /usr/share/elasticsearch
	
	# 执行安装命令, 请安装 ES 对应版本的分词器, https://github.com/medcl/elasticsearch-analysis-ik/releases
	# 注意 ik 的版本要与 es 的版本对应上
	./bin/elasticsearch-plugin install https://github.com/medcl/elasticsearch-analysis-ik/releases/download/v5.6.8/elasticsearch-analysis-ik-5.6.8.zip

	# 验证, PWD 变量指向 es 的安装目录
	ls $PWD/plugins
	
	# 重启 es1 容器
	docker restart es1

ik 带有两个分词器：

1. ik_max_word：会将文本做最细粒度的拆分；尽可能多的拆分出词语
2. ik_smart：会做最粗粒度的拆分；已被分出的词语将不会再次被其它词语占有

使用该方式安装 ik 可能会导致 es 的配置文件发生变化， 所以建议使用方式2进行 ik 分词器的安装

 

ik 分词器安装(zip包安装)

	cd /data/es/plugins
	
	wget https://github.com/medcl/elasticsearch-analysis-ik/releases/download/v5.6.8/elasticsearch-analysis-ik-5.6.8.zip
	
	
	unzip elasticsearch-analysis-ik-5.6.8.zip
	
	cp -r elasticsearch/* plugin1/ik
	cp -r elasticsearch/* plugin2/ik
	cp -r elasticsearch/* plugin3/ik

 

plugins 挂载目录结构

# 挂载： /data/es/plugins/plugin1:/usr/share/elasticsearch/plugins
# 容器启动后
plugins/
├── plugin1
│   └── ik
│       ├── commons-codec-1.9.jar
│       ├── commons-logging-1.2.jar
│       ├── config
│       ├── elasticsearch
│       ├── elasticsearch-analysis-ik-5.6.8.jar
│       ├── httpclient-4.5.2.jar
│       ├── httpcore-4.4.4.jar
│       └── plugin-descriptor.properties
├── plugin2
│   └── ik
│       ├── commons-codec-1.9.jar
│       ├── commons-logging-1.2.jar
│       ├── config
│       ├── elasticsearch
│       ├── elasticsearch-analysis-ik-5.6.8.jar
│       ├── httpclient-4.5.2.jar
│       ├── httpcore-4.4.4.jar
│       └── plugin-descriptor.properties
└── plugin3
    └── ik
        ├── commons-codec-1.9.jar
        ├── commons-logging-1.2.jar
        ├── config
        ├── elasticsearch
        ├── elasticsearch-analysis-ik-5.6.8.jar
        ├── httpclient-4.5.2.jar
        ├── httpcore-4.4.4.jar
        └── plugin-descriptor.properties

 

挂载 ik 目录成功案例

	docker exec -it es1 bash
	
	# 注意是将 zip 包中的 elasticsearch 下的内容挂载到 /usr/share/elasticsearch/plugins 的 ik 目录下
	ls /usr/share/elasticsearch/plugins/ik/
	
		commons-codec-1.9.jar  commons-logging-1.2.jar	config	elasticsearch  elasticsearch-analysis-ik-5.6.8.jar  httpclient-4.5.2.jar  httpcore-4.4.4.jar  plugin-descriptor.properties

 

环境部署

# 注意需要把 ik-plugin 目录挂载到容器
	docker run -d -e ES_JAVA_OPTS="-Xms256m -Xmx256m" \
		-p 2181:2181 -p 7050:7050 \
		-v /data/es/es1.yml:/usr/share/elasticsearch/config/elasticsearch.yml \
		-v /data/es/data1:/usr/share/elasticsearch/data \
		-v /data/es/plugins/plugin1:/usr/share/elasticsearch/plugins \
		--name es1 elasticsearch:5.6.8
	
	
	docker run -d -e ES_JAVA_OPTS="-Xms256m -Xmx256m" \
		-p 2888:2888 -p 7051:7051 \
		-v /data/es/es2.yml:/usr/share/elasticsearch/config/elasticsearch.yml \
		-v /data/es/data2:/usr/share/elasticsearch/data \
		-v /data/es/plugins/plugin2:/usr/share/elasticsearch/plugins \
		--name es2 elasticsearch:5.6.8
	
	
	docker run -d -e ES_JAVA_OPTS="-Xms256m -Xmx256m" \
		-p 3888:3888 -p 7053:7053 \
		-v /data/es/es3.yml:/usr/share/elasticsearch/config/elasticsearch.yml \
		-v /data/es/data3:/usr/share/elasticsearch/data \
		-v /data/es/plugins/plugin3:/usr/share/elasticsearch/plugins \
		--name es3 elasticsearch:5.6.8
	
	# 启动 es-manager 容器实例
	docker run -d -p 7058:9100 --name es-manager  mobz/elasticsearch-head:5	

	# 移除掉已有 elasticsearch 相关的容器
	docker rm -f $(docker ps -a | grep "elasticsearch" | awk '{print $1}')

 

测试

# create a index
curl -XPUT http://127.0.0.1:2181/index

# create a mapping
curl -XPOST http://127.0.0.1:2181/index/fulltext/_mapping -d'
{
	"properties": {
            "content": {
                "type": "text",
                "analyzer": "ik_max_word",
                "search_analyzer": "ik_max_word"
            }
        }
}'

# index some docs
curl -X POST http://127.0.0.1:2181/index/fulltext/1 -d'
{"content":"美国留给伊拉克的是个烂摊子吗"}
'

curl -XPOST http://127.0.0.1:2181/index/fulltext/2 -d'
{"content":"公安部：各地校车将享最高路权"}
'

curl -XPOST http://127.0.0.1:2181/index/fulltext/3 -d'
{"content":"中韩渔警冲突调查：韩警平均每天扣1艘中国渔船"}
'

curl -XPOST http://127.0.0.1:2181/index/fulltext/4 -d'
{"content":"中国驻洛杉矶领事馆遭亚裔男子枪击 嫌犯已自首"}
'



curl -XPOST http://127.0.0.1:2181/index/fulltext/_search -d'
{
    "query" : { "match" : { "content" : "中国" }},
    "highlight" : {
        "pre_tags" : ["", ""],
        "post_tags" : ["", ""],
        "fields" : {
            "content" : {}
        }
    }
}'

 

附录 - 参考网址

• elasticsearch-analysis-ik 5.x