Elasticsearch 常用语法手册

🧰 Elasticsearch 常用语法手册

📚 目录

• 索引操作
• 文档操作
• 查询操作
• 聚合查询
• 健康与状态查看
• 常见问题与注意事项

---

🔹 索引操作

查询全部索引

GET _search

创建索引

PUT /es_db

创建索引并设置分片数和副本数

PUT /es_db
{"settings": {"number_of_shards": 3,"number_of_replicas": 2}
}

查询索引是否存在

HEAD /es_db

查询索引详情

GET /es_db

删除索引

DELETE /es_db

修改索引配置（如副本数）

PUT /es_db/_settings
{"index": {"number_of_replicas": 1}
}

添加 IK 分词器

PUT /es_db
{"settings": {"index.analysis.analyzer.default.type": "ik_max_word"}
}

---

🔹 文档操作

添加文档

PUT /es_db/_doc/1
{"name": "张三","age": 10,"address": "深圳市宝安区海谷科技大厦"
}

查询文档

GET /es_db/_search

局部更新文档

POST /es_db/_update/5
{"doc": {"age": 22}
}

删除文档

DELETE /es_db/_doc/5

---

🔹 查询操作

条件查询（match）

GET /es_db/_search
{"from": 0,"size": 20,"query": {"match": {"name": "张三"}}
}

条件查询（q 参数）

GET /es_db/_search?q=name:庆

短语匹配查询（match_phrase）

POST /es_db/_search
{"query": {"match_phrase": {"name": "张三"}}
}

使用过滤器查询（post_filter）

GET /es_db/_search
{"query": {"match_all": {}},"post_filter": {"range": {"age": {"gte": 10,"lte": 20}}}
}

高亮显示

POST /es_db/_search
{"query": {"match_phrase": {"name": "张三"}},"highlight": {"fields": {"name": {}}}
}

---

🔹 聚合查询

terms 聚合（按字段统计）

GET /es_db/_search
{"query": { "match_all": {} },"aggs": {"name": {"terms": {"field": "address.keyword"}}}
}

⚠️ 注意：text 类型字段不能直接用于聚合，需使用 .keyword 子字段或开启 fielddata=true（占用较多内存）

avg 聚合（求平均值）

GET /es_db/_search
{"query": { "match_all": {} },"aggs": {"name": {"avg": {"field": "age"}}}
}

---

🔹 健康与状态查看

查看集群健康状态

GET _cat/health

查看索引情况

GET _cat/indices?v

---

❗ 常见问题与注意事项

text vs keyword

• text 类型适合全文搜索，会进行分词。
• keyword 类型不会分词，适合精确匹配、排序、聚合等操作。
• 如果需要对 text 字段进行排序或聚合，可以：
  • 使用 .keyword 子字段；
  • 或在映射中设置 "fielddata": true，但注意内存消耗较大。

示例字段映射

PUT /es_db
{"mappings": {"properties": {"address": {"type": "text","fields": {"keyword": { "type": "keyword" }}}}}
}

排序 + 分页查询示例

GET /es_db/_search
{"from": 0,"size": 10,"query": {"bool": {"must": [{ "match": { "name": "张三" } }],"filter": [{ "range": { "age": { "gte": 18 } } }]}},"sort": [{ "createTime": "desc" }]
}

---