1. 使用场景介绍

搜索功能支持：拼音检索，中文检索，拼音中文混合检索
例如：输入：l德h
【期望结果】：刘德华 和刘德华4
【不期望结果】：刘得华 、刘的华

2. 下载pinyin 插件

github地址
注意：下载的版本要与自己的ES版本一致

3. 修改插件源码以及安装

注意：
1）目前v7.13.1 已经支持拼音中文混合检索 可以直接安装插件直接使用
2）我本地目前是v7.9.3 ，所以需要对源码进行修改；如果你的ES版本也是低于v7.13.1版本；也需要进行修改；
我修改方法:
1）下载源码, checkout tag-v7.9.3 源码和tag-v7.13.1源码
2）通过compare进行比较，直接把v7.13.1 多余的代码复制到 v7.9.3 中
3）修改pom 的elasticsearch.version为7.9.3
4）maven 打包 mvn clean package
5）将\target\releases\elasticsearch-analysis-pinyin-7.9.3.zip 解压到\plugins\analysis-pinyin 文件夹下

4. 测试

创建索引

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
############################创建索引#########################
PUT /my_index
{
  "settings": {
    "analysis": {
      "analyzer": {
        "pinyin_chinese_analyzer": {
          "tokenizer": "pinyin_tokenizer"
        },
        "pinyin_analyzer": {
          "tokenizer": "pinyin_chinese_tokenizer"
        }
      }, 
      "tokenizer": {
        "pinyin_chinese_tokenizer": {
          "type": "pinyin",
          "keep_first_letter": false,
          "keep_separate_first_letter": false,
          "keep_full_pinyin":false,
          "keep_original":false,
          "limit_first_letter_length":50,
          "keep_separate_chinese": true,
          "lowercase":true
          
        },
        "pinyin_tokenizer": {
          "type": "pinyin",
          "keep_first_letter": false,
          "keep_separate_first_letter": true,
          "keep_full_pinyin":true,
          "keep_original":false,
          "limit_first_letter_length":50,
          "keep_separate_chinese": true,
          "lowercase":true
        }
      }
    }
  }
}

查询索引

1
2
#####################查询索引#########################
GET /_cat/indices

Mapping设置

1
2
3
4
5
6
7
8
9
10
POST /my_index/_mapping 
{
  "properties": {
      "name": {
          "type": "text",
          "analyzer": "pinyin_chinese_analyzer",
          "search_analyzer": "pinyin_analyzer"
      }
  }
}

查询Mapping设置是否生效

1
2
#-------------------查询Mapping-----------------------
GET /my_index/_mapping?pretty

测试索引下定义的分词器

1
2
3
4
5
6
7
8
9
10
11
12
#--------------------测试分词器----------------------
GET /my_index/_analyze
{
   "text": ["刘德华"],
   "analyzer": "pinyin_chinese_analyzer"
}

GET /my_index/_analyze
{
   "text": ["刘德h"],
   "analyzer": "pinyin_analyzer"
}

创建数据

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
###################创建数据########################
POST /my_index/_doc/1
{"name":"刘德华"}

PUT /my_index/_doc/2
{"name":"刘的华"}

PUT /my_index/_doc/3
{"name":"刘得华"}

PUT /my_index/_doc/4
{"name":"刘德华4"}

PUT /my_index/_doc/5
{"name":"刘5德5华5"}

查询所有数据

1
2
3
4
5
6
7
####################查询数据############################
GET /my_index/_search
{
  "query": {
    "match_all": {}
  }
}

拼音中文混合检索

1
2
3
4
5
6
7
8
9
####################检索数据########################
GET /my_index/_search
{
  "query": {
    "match_phrase": {
      "name": "l德h"
    }
  }
}