政府网站设计模板google入口
Elasticsearch RESTful API入门：基础搜索与查询DSL
本文为Elasticsearch初学者详细解析RESTful API的核心操作与查询DSL语法，包含大量实战示例及最佳实践。
一、Elasticsearch与RESTful API简介
Elasticsearch（ES）作为分布式搜索分析引擎，其RESTful API是与集群交互的核心方式。通过HTTP协议实现：
- ✅ 索引文档的CRUD操作
- ✅ 执行复杂的搜索查询
- ✅ 获取集群健康状况
- ✅ 管理索引生命周期
核心概念速览：
| 概念 | 说明 | 类比关系型数据库 |
|---|---|---|
| 索引(Index) | 文档的集合 | 数据库的表 |
| 文档(Document) | JSON格式的基本数据单元 | 表中的一行记录 |
| 分片(Shard) | 索引的水平分割单元 | 表分区 |
| 映射(Mapping) | 定义文档字段及类型 | 表结构定义 |
二、基础API操作实战
1. 索引管理
# 创建索引
PUT /products
{"settings": {"number_of_shards": 3,"number_of_replicas": 1},"mappings": {"properties": {"name": {"type": "text"},"price": {"type": "float"},"category": {"type": "keyword"},"created_at": {"type": "date"}}}
}# 删除索引 (谨慎操作！)
DELETE /products### 2. 文档操作```bash
# 添加文档
POST /products/_doc/1001
{"name": "无线蓝牙耳机","price": 299.0,"category": "电子产品","created_at": "2023-05-10"
}# 获取文档
GET /products/_doc/1001# 更新文档
POST /products/_update/1001
{"doc": {"price": 259.0}
}# 删除文档
DELETE /products/_doc/1001
三、搜索API核心机制
1. 搜索端点
所有搜索请求发送到_search端点：
GET /products/_search
2. 两种查询方式对比
| 方式 | 语法示例 | 适用场景 |
|---|---|---|
| URL参数查询 | ?q=category:电子产品 | 快速简单查询 |
| DSL请求体查询 | JSON结构描述复杂查询逻辑 | 生产环境推荐使用 |
四、查询DSL深度解析
1. 全文搜索 - match查询
GET /products/_search
{"query": {"match": {"name": {"query": "降噪耳机","operator": "and"}}}
}
-
对文本 分词处理 （ “降噪耳机” → [“降噪”,“耳机”]）
-
operator参数：and(必须全部包含) 或 or(包含任意词)
2. 精确匹配 - term查询
GET /products/_search
{"query": {"term": {"category.keyword": {"value": "电子产品"}}}
}
-
注意使用.keyword子字段进行未分词的精确匹配
-
适用于状态、标签等离散值字段
3. 范围查询 - range
GET /products/_search
{"query": {"range": {"price": {"gte": 200,"lte": 500}}}
}
-
支持操作符：
gt(>),gte(>=),lt(<),lte(<=) -
适用于数值、日期范围过滤
4. 布尔组合 - bool查询
GET /products/_search
{"query": {"bool": {"must": [{"match": {"name": "耳机"}}],"should": [{"term": {"category.keyword": "促销品"}},{"range": {"price": {"lte": 199}}}],"must_not": [{"term": {"brand.keyword": "A品牌"}}],"filter": [{"term": {"in_stock": true}}],"minimum_should_match": 1}}
}
| 子句 | 作用 | 是否影响相关性评分 |
|---|---|---|
| must | 必须满足，相当于AND | 是 |
| should | 应该满足，相当于OR | 是 |
| must_not | 必须不满足，相当于NOT | 否 |
| filter | 必须满足，但不参与评分 | 否 |
5. 短语搜索 - match_phrase
GET /products/_search
{"query": {"match_phrase": {"description": {"query": "高清防水","slop": 3}}}
}
-要求词语 按顺序完整出现
-slop参数允许中间间隔的词数
五、搜索结果处理技巧
1. 分页与排序
GET /products/_search
{"from": 10,"size": 5,"sort": [{"price": {"order": "asc"}},{"_score": {"order": "desc"}}],"query": {...}
}
2. 字段过滤
GET /products/_search
{"_source": ["name", "price"],"query": {...}
}
3. 结果分析
典型搜索结果结构：
{"took": 15, // 查询耗时(ms)"timed_out": false,"hits": {"total": {"value": 42, // 匹配总数"relation": "eq"},"max_score": 1.234, // 最高得分"hits": [ // 结果数组{"_index": "products","_id": "1001","_score": 1.234,"_source": { // 原始文档"name": "无线蓝牙耳机","price": 299.0}}]}
}
六、最佳实践与避坑指南
-
精确匹配陷阱
字符串字段默认同时创建text和keyword类型，精确匹配需用字段名.keyword -
性能优化
"bool": {"filter": [ // 不参与评分的条件放filter{"range": {"created_at": {"gte": "now-30d/d"}}}]
}
- 深度分页问题
避免使用from+size处理超过10,000条的结果集，改用search_after或scrollAPI - 安全防护
生产环境必须启用：
- X-Pack安全模块
- API密钥认证
- 网络访问控制
七、学习资源推荐
- 官方文档：Elasticsearch Reference
- 实战工具：
- Kibana Dev Tools
- Postman
- curl命令
附录：常用查询速查表
| 查询类型 | 用途 | 示例 |
|---|---|---|
| match | 全文搜索 | {“match”: {“title”: “ES”}} |
| term | 精确值匹配 | {“term”: {“status”: 1}} |
| range | 范围查询 | {“range”: {“age”: {“gte”: 18}}} |
| bool | 组合多个查询条件 | 见第四节示例 |
| match_phrase | 短语搜索 | {“match_phrase”: {“quote”: “to be or”}} |
下集预告《Elasticsearch RESTful API入门：全文搜索实战》