Appearance
附录
常用 API 速查
索引
| 操作 | 方法 | 路径示例 |
|---|---|---|
| 创建索引 | PUT | PUT /my_index |
| 查看索引 | GET | GET /my_index、GET _cat/indices?v |
| 删除索引 | DELETE | DELETE /my_index |
| 关闭/打开 | POST | POST /my_index/_close、POST /my_index/_open |
文档
| 操作 | 方法 | 路径示例 |
|---|---|---|
| 写入（指定 ID） | PUT | PUT /my_index/_doc/1 + body |
| 写入（自动 ID） | POST | POST /my_index/_doc + body |
| 读取 | GET | GET /my_index/_doc/1 |
| 部分更新 | POST | POST /my_index/_update/1 + {"doc":{...}} |
| 删除 | DELETE | DELETE /my_index/_doc/1 |
| 批量 | POST | POST _bulk + NDJSON body |
搜索与聚合
| 操作 | 方法 | 路径示例 |
|---|---|---|
| 搜索 | GET/POST | GET /my_index/_search + body（query、from、size、sort、aggs） |
| 聚合 | 同搜索 | 在 _search 的 body 里写 aggs |
_cat 常用
| 说明 | 路径 |
|---|---|
| 集群健康 | GET _cat/health?v |
| 索引列表 | GET _cat/indices?v |
| 节点 | GET _cat/nodes?v |
| 分片 | GET _cat/shards?v |
| 别名 | GET _cat/aliases?v |
其它
| 说明 | 路径 |
|---|---|
| 集群健康（JSON） | GET _cluster/health |
| 映射 | GET /my_index/_mapping |
| 设置 | GET /my_index/_settings |
| 分析器测试 | GET _analyze + body 或 GET /my_index/_analyze |
| Reindex | POST _reindex + body |
| 别名 | POST _aliases + body |
常见错误与排查
| 现象 | 可能原因 | 处理思路 |
|---|---|---|
| 4xx 索引已存在 | PUT 创建了已存在的索引 | 换名或先 DELETE 再创建 |
| 4xx 映射冲突 | 新字段类型与已有 mapping 冲突 | 新索引 + Reindex，或改业务字段名 |
| 4xx 文档未找到 | GET 的 ID 不存在 | 检查 ID 或索引名 |
| 5xx 超时 | 数据量大、查询/聚合太重 | 加条件、减 size、优化 query/aggs、加超时参数 |
| 5xx 无可用分片 | 主分片未分配（如磁盘满、节点掉线） | 查 _cluster/health、_cat/shards，修节点或磁盘 |
| 索引只读 | 磁盘使用率超水位 | 增加磁盘或删旧数据，恢复写权限 |
| 429 Too Many Requests | 写入或查询限流 | 降并发、限速、扩容 |
具体错误信息中的 type、reason 会给出更细原因，可结合 官方文档 排查。
术语中英对照
| 英文 | 中文 |
|---|---|
| Index | 索引 |
| Document | 文档 |
| Mapping | 映射 |
| Field | 字段 |
| Shard | 分片 |
| Primary Shard | 主分片 |
| Replica (Shard) | 副本（分片） |
| Cluster | 集群 |
| Node | 节点 |
| Query | 查询 |
| Query DSL | 查询 DSL |
| Aggregation | 聚合 |
| Bucket | 桶 |
| Metric | 指标 |
| Analyzer | 分析器 |
| Tokenizer | 分词器 |
| Token Filter | 词元过滤器 |
| Term | 词项 |
| Full-text | 全文 |
| Keyword | 关键字（类型）/ 关键词 |
| Relevance / Score | 相关度 / 分数 |
| Refresh | 刷新 |
| Flush | 刷盘 |
| Reindex | 重建索引 |
| Alias | 别名 |
| Snapshot | 快照 |
| ILM (Index Lifecycle Management) | 索引生命周期管理 |
教程到此处告一段落。建议多动手在 Kibana Dev Tools 中练习，并查阅 Elastic 官方文档 做进一步学习。