ES查询语法总结 - 教程

文章目录

• • • 一、全文检索查询
    • 二、精确查询
    • 三、复合查询
    • 四、特殊查询
    • 五、其他功能示例
    • 六、关键注意事项

一、全文检索查询

1. Match Query
   搜索分词后的文本字段（如 text 类型）：

   GET /products/_search
   {
     "query": {
       "match": {
         "description": "wireless headphones"
       }
     }
   }

   • 自动对 "wireless headphones" 分词（如拆为 wireless 和 headphones），匹配任一词汇的文档。

2. Multi-match Query
   跨多个字段搜索：

   {
     "query": {
       "multi_match": {
         "query": "apple",
         "fields": ["title", "brand", "description"]
       }
     }
   }

---

二、精确查询

1. Term Query
   精确匹配未分词的 keyword 字段：

   {
     "query": {
       "term": {
         "status": {
           "value": "published"  // 精确匹配字段值
         }
       }
     }
   }

2. Terms Query
   匹配字段中包含任一指定值的文档：

   {
     "query": {
       "terms": {
         "tags": ["electronics", "sale"]  // 匹配含 electronics 或 sale 的文档
       }
     }
   }

3. Range Query
   数值或日期范围过滤：

   {
     "query": {
       "range": {
         "price": {
           "gte": 100,
           "lte": 1000
         }
       }
     }
   }

4. Exists Query
   筛选存在某字段的文档：

   {
     "query": {
       "exists": {
         "field": "author"  // 返回包含 author 字段的文档
       }
     }
   }

---

三、复合查询

1. Bool Query 组合逻辑条件（AND/OR/NOT）：

   {
     "query": {
       "bool": {
         "must": [  // 必须满足
           { "match": { "title": "phone" } },
           { "range": { "price": { "lte": 500 } } }
         ],
         "must_not": [  // 必须不满足
           { "term": { "brand": "A" } }
         ],
         "should": [  // 满足任意一个
           { "term": { "color": "black" } },
           { "term": { "color": "silver" } }
         ],
         "minimum_should_match": 1,  // 至少满足 1 个 should 条件
         "filter": [  // 过滤，不参与评分
           { "term": { "in_stock": true } }
         ]
       }
     }
   }

---

四、特殊查询

1. Match_all Query
   匹配所有文档：

   {
     "query": {
       "match_all": {}
     }
   }

2. Wildcard Query
   通配符匹配（* 匹配任意字符，? 匹配单个字符）：

   {
     "query": {
       "wildcard": {
         "sku": "pro-*"  // 匹配 pro-123, pro-abc 等
       }
     }
   }

3. Prefix Query
   前缀匹配：

   {
     "query": {
       "prefix": {
         "city": "new"  // 匹配 new york, new delhi 等
       }
     }
   }

4. Fuzzy Query
   容错匹配（允许拼写错误）：

   {
     "query": {
       "fuzzy": {
         "text": {
           "value": "quick",
           "fuzziness": "AUTO"  // 自动允许 1-2 个字符的差异
         }
       }
     }
   }

---

五、其他功能示例

1. 分页与排序

   {
     "query": { "match_all": {} },
     "from": 10,  // 跳过前 10 条
     "size": 5,   // 返回 5 条结果
     "sort": [
       { "price": { "order": "desc" } }  // 按价格降序排序
     ]
   }

2. 高亮匹配内容

   {
     "query": {
       "match": { "content": "Elasticsearch" }
     },
     "highlight": {
       "fields": {
         "content": {}  // 高亮 content 字段中的匹配词
       }
     }
   }

---

六、关键注意事项

• 默认返回 10 条数据：在未显式设置 size 参数时，Elasticsearch 的 search 查询默认仅返回匹配结果的前 10 条记录。
• 字段类型：term 适用于 keyword 类型，match 适用于 text 类型。
• 性能：优先用 filter 替代 must 进行精确过滤（如状态、时间范围），减少评分计算。