elasticsearch拼写纠错之Term Suggester
- 2022 年 1 月 16 日
- 筆記
- Elastic search
一、什么是拼写纠错
拼写纠错就是搜索引擎可以智能的感知用户输入关键字的错误,并使用纠正过的关键字进行搜索展示给用户;拼写纠错是一种改善用户体验的功能;
elasticsearch提供了以下不同类型的suggester来完成拼写纠错和自动完成功能;
term suggester主要针对单个的term分词进行纠正的场景;
phrase suggester主要针对整个短语的拼写纠正场景;
completion suggester主要提供一种快速高效的自动提示功能;
二、Term Suggester基于单个词的拼写纠错
Term Suggester会将用户输入的text进行解析分解成单个的word,然后针对每个word进行纠错;
elasticsearch的suggester请求的还是_search端点,要发送一个Term suggester请求,我们需要
1.在body中添加suggest字段;
2.指定我们的suggest的名字,我们可以使用不同的名字同时进行多个拼写纠错, 其最终的执行结果在response中也会使用这个名字进行区分;
3.通过text字段指定要纠正的文本;
4.指定要使用的suggester类型,这里使用term;
5.指定要在哪个字段上进行拼写纠错;
POST blogs/_search
{
"suggest": {
"my_sug": {
"text": "hots vlna",
"term": {
"field": "content"
}
}
}
}
elasticsearch返回结果中的suggest部分包含对应的结果;
不同名字的suggester在返回结果中作为suggest对象的字段,其作为数组承载每个text分词的建议结果;
每个原始的word作为一个对象,对象会记录原始word的基本信息及所有的建议词;
每个建议词对象会包含文本、打分、出现频率;
{
"suggest" : {
"my_sug" : [
{
"text" : "hots",
"offset" : 0,
"length" : 4,
"options" : [
{
"text" : "host",
"score" : 0.75,
"freq" : 109
},
{
"text" : "http",
"score" : 0.5,
"freq" : 235
},
{
"text" : "https",
"score" : 0.5,
"freq" : 9
},
{
"text" : "hours",
"score" : 0.5,
"freq" : 6
},
{
"text" : "hole",
"score" : 0.5,
"freq" : 5
}
]
},
{
"text" : "vlna",
"offset" : 5,
"length" : 4,
"options" : [
{
"text" : "vlan",
"score" : 0.75,
"freq" : 200
},
{
"text" : "vpna",
"score" : 0.75,
"freq" : 3
},
{
"text" : "vlan1",
"score" : 0.5,
"freq" : 111
},
{
"text" : "vlans",
"score" : 0.5,
"freq" : 11
},
{
"text" : "vlan8",
"score" : 0.5,
"freq" : 10
}
]
}
]
}
}
三、Term Suggester的通用配置选项
Term Suggester基于编辑距离来计算字符串的相似性;如果一个建议词通过更少字符的改变、添加、删除来转变成原始的字符串,那么这就是一个更好的建议词;例如host通过变换t和s的位置变成hots,则二者的编辑距离是1;
text既可以在suggest里边单独设置,也可以在全局设置;
POST blogs/_search
{
"suggest": {
"text": "hots vlna",
"content_sug": {
"term": {
"field": "content"
}
},
"title_sug": {
"term": {
"field": "title"
}
}
}
}
analyzer对text设置的文本进行analyse处理,默认使用field字段的search analyzer;
POST blogs/_search
{
"suggest": {
"my_sug": {
"text": "hots vlna",
"term": {
"analyzer":"standard",
"field": "content"
}
}
}
}
size设置每个word返回的建议词的数量,默认是5个;
POST blogs/_search
{
"suggest": {
"my_sug": {
"text": "hots vlna",
"term": {
"analyzer":"standard",
"field": "content",
"size":6
}
}
}
}
sort设置每个word对应的建议词的排序方式,由于每个建议词只包含text、score、freq,这就涉及以哪个字段先排序;
score,先使用score排序,后使用freq排序,最后使用建议词排序;
frequency,先使用freq排序,后使用score排序,最后使用建议词排序;
POST blogs/_search
{
"suggest": {
"my_sug": {
"text": "hots",
"term": {
"field": "content",
"sort":"frequency"
}
}
}
}
{
"suggest" : {
"my_sug" : [
{
"text" : "hots",
"offset" : 0,
"length" : 4,
"options" : [
{
"text" : "http",
"score" : 0.5,
"freq" : 235
},
{
"text" : "host",
"score" : 0.75,
"freq" : 109
},
{
"text" : "https",
"score" : 0.5,
"freq" : 9
},
{
"text" : "hours",
"score" : 0.5,
"freq" : 6
},
{
"text" : "hole",
"score" : 0.5,
"freq" : 5
}
]
}
]
}
}
suggest_mode,主要控制针对什么样的词会返回建议词,以及返回那些建议词;
missing,默认的选项,只有输入的词在对应字段的分词中不存在,才有可能返回建议词;
popular,只返回在更多的文档中出现的建议词;
always,任何的建议词都可以返回;
由于vlan322在字段content里已经存在,使用missing模式没有任何返回结果;
POST blogs/_search
{
"suggest": {
"my_sug": {
"text": "vlan322",
"term": {
"field": "content",
"suggest_mode":"missing"
}
}
}
}
{
"suggest" : {
"my_sug" : [
{
"text" : "vlan322",
"offset" : 0,
"length" : 7,
"options" : [ ]
}
]
}
}
使用popular模式则会返回对应的建议词;
POST blogs/_search
{
"suggest": {
"my_sug": {
"text": "vlan322",
"term": {
"field": "content",
"suggest_mode":"popular"
}
}
}
}
{
"suggest" : {
"my_sug" : [
{
"text" : "vlan322",
"offset" : 0,
"length" : 7,
"options" : [
{
"text" : "vlan0022",
"score" : 0.71428573,
"freq" : 5
},
{
"text" : "vlan30",
"score" : 0.6666666,
"freq" : 14
},
{
"text" : "vlan20",
"score" : 0.6666666,
"freq" : 7
},
{
"text" : "vlan.2",
"score" : 0.6666666,
"freq" : 6
},
{
"text" : "vlan12",
"score" : 0.6666666,
"freq" : 6
}
]
}
]
}
}
四、Term Suggester的专有配置选项
max_edits,主要控制可以包含的最大编辑距离的建议词,可以取值1或者2,默认值为2;
POST blogs/_search
{
"suggest": {
"my_sug": {
"text": "vlan322",
"term": {
"field": "content",
"max_edits":1
}
}
}
}
{
"suggest" : {
"my_sug" : [
{
"text" : "htpt",
"offset" : 0,
"length" : 4,
"options" : [
{
"text" : "http",
"score" : 0.75,
"freq" : 235
}
]
}
]
}
}
prefix_length,主要控制原始word的开头多少个字符不参与拼错纠正,默认值为1,提高这个值可以提高性能;
POST blogs/_search
{
"suggest": {
"my_sug": {
"text": "vlan322",
"term": {
"field": "content",
"prefix_length":2
}
}
}
}
{
"suggest" : {
"my_sug" : [
{
"text" : "htpt",
"offset" : 0,
"length" : 4,
"options" : [ ]
}
]
}
}
min_word_length,控制建议词的最小字符长度,默认是4;
POST blogs/_search
{
"suggest": {
"my_sug": {
"text": "vlan32",
"term": {
"field": "content",
"min_word_length":7
}
}
}
}
shard_size,主要控制每个分片返回的建议词的数量,通过增大这个设置数量可以提高建议词的准确性,但是可能会降低整体的性能;默认值跟size保持一致;
POST blogs/_search
{
"suggest": {
"my_sug": {
"text": "vlan32",
"term": {
"field": "content",
"shard_size":3,
"size":10,
}
}
}
}
{
"suggest" : {
"my_sug" : [
{
"text" : "vlan32",
"offset" : 0,
"length" : 6,
"options" : [
{
"text" : "vlan30",
"score" : 0.8333333,
"freq" : 14
},
{
"text" : "vlan.2",
"score" : 0.8333333,
"freq" : 6
},
{
"text" : "vlan12",
"score" : 0.8333333,
"freq" : 6
}
]
}
]
}
}
max_inspections,通过与shards_size相乘控制shard级别检测可选建议词的数量,默认值5;没有测试出具体的效果;
min_doc_freq,主要控制返回建议词至少在index中至少多个document中出现过,默认值为0,通过提高这个值可以提高准确率,可以设置具体的值也可以设置百分比;这是一个基于shard level配置选项;
POST blogs/_search
{
"suggest": {
"my_sug": {
"text": "vlan32",
"term": {
"field": "content",
"min_doc_freq":3
}
}
}
}
{
"suggest" : {
"my_sug" : [
{
"text" : "vlan32",
"offset" : 0,
"length" : 6,
"options" : [
{
"text" : "vlan30",
"score" : 0.8333333,
"freq" : 14
},
{
"text" : "vlan.2",
"score" : 0.8333333,
"freq" : 6
},
{
"text" : "vlan12",
"score" : 0.8333333,
"freq" : 6
},
{
"text" : "vlan2",
"score" : 0.8,
"freq" : 8
},
{
"text" : "vlan10",
"score" : 0.6666666,
"freq" : 55
}
]
}
]
}
}
max_term_freq,主要控制建议词在文档中出现的最多的次数,可以设置具体数值和百分比;默认值0.01f;降低这个值可以排除更多的建议词从而提高性能;这个也是shard级别的配置;
POST blogs/_search
{
"suggest": {
"my_sug": {
"text": "vlan32",
"term": {
"field": "content",
"max_term_freq":1
}
}
}
}
string_distance,设置计算编辑距离的具体算法,可选值有internal、damerau_levenshtein、levenshtein、jaro_winkler、ngram;