云搜索服务
云搜索服务
云搜索服务
文档指南
请输入
用户指南
实例管理
可视化配置
插件管理
搜索管理
可观测
Cerebro 管理
任务中心
Logstash 用户指南
最佳实践
连接实例
数据集成
应用构建
API 参考
实例查询
实例管理
- 文档首页
云搜索服务用户指南实例管理搜索管理同义词配置同义词短语分词使用说明
复制全文
下载 pdf同义词短语分词使用说明
文档反馈
问问助手本文介绍同义词短语的使用说明。
同义词插件
使用同义词插件可提高搜索灵活性、关键词召回率和搜索质量。default_dynamic_synonym 用于同义词简单替换。default_dynamic_synonym_graph 在功能上更加先进，相比于 default_dynamic_synonym 支持短语同义词。例如：清华大学,Tsinghua University 作为短语同义词的场景下，需使用 default_dynamic_synonym_graph。
使用差异
添加分词词典和同义词词典
添加分词词典
北京大学，北大，PKU，清华大学，清华
添加同义词词典
北京大学,北大,PKU
清华大学,清华,Tsinghua University
添加停用词
的,是
验证差异
创建测试索引
PUT /ik-synonym
{
"settings": {
"analysis": {
"analyzer": {
"test_synonym_graph": {
"filter": [
"default_dynamic_synonym_graph"
],
"tokenizer": "ik_smart"
},
"test_synonym" :{
"filter": [
"default_dynamic_synonym"
],
"tokenizer": "ik_smart"
}
}
}
},
"mappings": {
"properties": {
"content_synonym": {
"type": "text",
"analyzer": "test_synonym"
},
"content_synonym_graph": {
"type": "text",
"analyzer": "test_synonym_graph"
}
}
}
}
// 使用 _analyze API 查看差异
GET /ik-synonym/_analyze
{
"field":"content_synonym_graph",
"text":"清华大学是世界著名的高等学府。"
}
GET /ik-synonym/_analyze
{
"field":"content_synonym",
"text":"清华大学是世界著名的高等学府。"
}
// index doc
POST ik-synonym/_bulk
{ "index": { "_index": "ik-synonym", "_id": "1" } }
{ "content_synonym": "清华大学是世界著名的高等学府。","content_synonym_graph": "清华大学是世界著名的高等学府。"}
// 在搜索时体验差异，通过高亮体现差异
GET ik-synonym/_search
{
"query":{
"match_phrase": {
"content_synonym_graph":"tsinghua university"
}
},
"highlight": {
"type": "unified",
"fields": {
"content_synonym_graph": {}
}
}
}
GET ik-synonym/_search
{
"query":{
"match_phrase": {
"content_synonym":"tsinghua university"
}
},
"highlight": {
"type": "unified",
"fields": {
"content_synonym": {}
}
}
}
- default_dynamic_synonym 搜索高亮结果如下所示。
- "<em>清华大学</em>是<em>世界</em>著名的高等学府。"
-
- default_dynamic_synonym_graph 搜索高亮结果如下所示。
- "<em>清华大学</em>是世界著名的高等学府。"
通过测试可见，default_dynamic_synonym_graph 精准将清华大学高亮显示，而 default_dynamic_synonym 将清华大学和世界高亮显示，不符合搜索意图。
分析差异
通过 _termvectors API 查看词向量信息。
GET /ik-synonym/_termvectors/1?fields=content_synonym_graph
GET /ik-synonym/_termvectors/1?fields=content_synonym
通过查看 _termvectors，可以发现：
- 使用 default_dynamic_synonym 时，university 与世界的 position、start_offset、end_offset 一致，导致 university 和世界成为同义词，在搜索时就会出现与预期不一致的情况。
- 使用 default_dynamic_synonym_graph 时，university 与世界的 position 不一致，而 start_offset 和 end_offset 一致，因此准确表示出短语同义词。
最近更新时间：2025.12.17 10:38:48
这个页面对您有帮助吗？
有用
有用
无用
无用