ElasticSearch1.7.1拼音插件elasticsearch-analysis-pinyin-1.3.3使用介绍

时间:2022-09-13 00:00:46

ElasticSearch拼音插件elasticsearch-analysis-pinyin使用介绍

https://my.oschina.net/xiaohui249/blog/214505

摘要: elasticsearch-analysis-pinyin是ElasticSearch的一个分词插件,能够实现拼音分词索引。本文主要介绍该插件的安装和具体使用方法。
关于elasticsearch-analysis-pinyin的介绍,就此省略,看完此文后你就会知道它有多神奇。

一、安装

安装该插件的前提是你已经安装了ES(ElasticSearch),如果没有参照安装向导。

安装该插件需要2个jar包,一个当然是elasticsearch-analysis-pinyin.jar,另一个是pinyin4j.jar。很多网站都有下载,但是建议亲自编译elasticsearch-analysis-pinyin生成,因为这样不会有版本问题。好,下面介绍编译源码获取上述两个jar包的方法。

1、下载源码(需要安装了git)

    git clone https://github.com/medcl/elasticsearch-analysis-pinyin.git

2、编译(需要安装了maven)

    进入download下来的源码目录:cd elasticsearch-analysis-pinyin,然后执行编译命令:mvn clean install -Dmaven.test.skip。编译成功之后,你将在elasticsearch-analysis-pinyin/target目录中看到elasticsearch-analysis-pinyin的jar包,我编译完成之后,生成的jar包名称为:elasticsearch-analysis-pinyin-1.2.1.jar,然后elasticsearch-analysis-pinyin/lib目录中看到pinyin4j的jar包,我的jar包名称为:pinyin4j-2.5.0.jar。

3、具体安装

    在ES_HOME目录下创建一个plugins目录(如果没有的话),然后在plugins目录下创建pinyin目录,将前两个步骤中得到的jar包拷贝到ES_HOME/plugins/pinyin目录下面。ok,插件安装基本完成,easy吧!

二、如何使用

首先建议重新启动ES服务。

1、分词测试

    (1) 创建一个测试索引:       

curl -XPUT http://localhost:9200/medcl/ -d'
{
"index" : {
"analysis" : {
"analyzer" : {
"pinyin_analyzer" : {
"tokenizer" : "my_pinyin",
"filter" : ["standard"]
}
},
"tokenizer" : {
"my_pinyin" : {
"type" : "pinyin",
"first_letter" : "none",
"padding_char" : " "
}
}
}
}
}'
(2) 通过浏览器请求分词效果

        在浏览器输入

http://your_es_host:9200/medcl/_analyze?text=%e5%88%98%e5%be%b7%e5%8d%8e&analyzer=pinyin_analyzer
返回结果如下,分词成功,该插件能够轻易的得到中文对应的拼音分词,然后搜索可以对输入的拼音提示对应的中文,提高搜索体验。

{"tokens":[{"token":"liu de hua ","start_offset":0,"end_offset":3,"type":"word","position":1}]}

2、使用该插件创建索引,实现上图的拼音提示功能

    (1) 创建空索引,设置分词器       

curl -XPOST http://localhost:9200/medcl/_close (if you had create index 'medcl', do this)
curl -XPUT http://localhost:9200/medcl/_settings -d'
{
"index" : {
"analysis" : {
"analyzer" : {
"pinyin_analyzer" : {
"tokenizer" : ["my_pinyin"],
"filter" : ["standard","nGram"]
}
},
"tokenizer" : {
"my_pinyin" : {
"type" : "pinyin",
"first_letter" : "prefix",
"padding_char" : ""
}
}
}
}
}'
curl -XPOST http://localhost:9200/medcl/_open (if you had create index 'medcl', do this)
(2) 创建Mapping,即索引结构以及字段配置

curl -XPOST http://localhost:9200/medcl/folks/_mapping -d'
{
"folks": {
"properties": {
"name": {
"type": "multi_field",
"fields": {
"name": {
"type": "string",
"store": "no",
"term_vector": "with_positions_offsets",
"analyzer": "pinyin_analyzer",
"boost": 10
},
"primitive": {
"type": "string",
"store": "yes",
"analyzer": "keyword"
}
}
}
}
}
}'
(3) 开始索引数据

curl -XPOST http://localhost:9200/medcl/folks/andy -d'{"name":"刘德华"}'
(4) 检索数据

    在浏览器一次输入下面的连接,你将会搜索得到上面索引的那个记录:刘德华。

http://localhost:9200/medcl/folks/_search?q=name:刘
http://localhost:9200/medcl/folks/_search?q=name:刘德
http://localhost:9200/medcl/folks/_search?q=name:liu
http://localhost:9200/medcl/folks/_search?q=name:ldh
http://localhost:9200/medcl/folks/_search?q=name:dehua