添加文档

在 Elasticsearch 中，文档是存储的最小单位，通常以 JSON 格式表示。添加文档即向指定索引写入数据，是构建搜索与分析系统的基础操作。

1. 添加单条文档（自动生成 ID）

使用 POST 请求，Elasticsearch 会自动生成文档 ID。

POST /my-index/_doc
{
  "title": "Elasticsearch 教程",
  "author": "张三",
  "publish_date": "2024-01-01",
  "views": 100
}

返回结果包含自动生成的 _id。

2. 添加单条文档（自定义 ID）

使用 PUT 请求，可以指定文档 ID，方便后续更新和删除。

PUT /my-index/_doc/1
{
  "title": "Elasticsearch 教程",
  "author": "李四",
  "publish_date": "2024-01-02",
  "views": 150
}

3. 注意事项

• 索引名称必须存在，否则会返回错误
• 文档字段应符合映射定义，避免类型冲突
• 自定义 ID 需保证唯一，否则会覆盖原文档

---

掌握添加文档的方法，是实现数据写入和搜索的第一步，为后续查询与分析奠定基础。