NoSQL 与搜索 / 系统课时
读取与删除文档
读取与删除文档
本课围绕文档 ID 完成读取、存在性判断、删除和删除后验证,并通过 HTTP 状态与响应体区分“文档不存在”“索引不存在”和“删除成功”三类结果。
学习目标
- 能使用索引名和文档 ID 精确读取数据
- 能删除指定文档并验证删除结果
- 能根据状态码、
found和result判断资源状态
准备测试文档
为了保证本课可以独立跟做,先向 products-demo 写入一条 ID 为 1001 的商品文档。索引不存在时,Elasticsearch 通常会自动创建普通索引,但生产环境更推荐提前定义映射和索引模板。
PUT /products-demo/_doc/1001
{
"name": "机械键盘",
"price": 399.0,
"in_stock": true
}预期结果(仅列关键字段)
{
"_index": "products-demo",
"_id": "1001",
"_version": 1,
"result": "created"
}如果该 ID 已存在,result 可能为 updated,_version 也可能大于 1。这不会影响后续读取与删除练习,只要请求成功即可。
读取存在的文档
文档读取接口使用 GET /<index>/_doc/<id>。它直接按 ID 定位文档,不执行全文检索,也不会返回相关性评分。
GET /products-demo/_doc/1001预期结果(省略版本与序列号字段)
{
"_index": "products-demo",
"_id": "1001",
"found": true,
"_source": {
"name": "机械键盘",
"price": 399.0,
"in_stock": true
}
}found: true 表示目标文档存在,业务字段位于 _source。默认读取是实时的,因此刚完成写入后通常可以立即通过 GET 接口取回,不必等待文档对搜索接口可见。
只需要少数字段时,可以使用 _source 过滤减少返回数据,例如 GET /products-demo/_doc/1001?_source=name,price。
区分不存在的响应
读取一个不存在的 ID,会得到 HTTP 404 Not Found,响应中仍会包含索引名、ID 和 found: false。
GET /products-demo/_doc/9999预期结果
{
"_index": "products-demo",
"_id": "9999",
"found": false
}文档不存在与索引不存在都可能返回 404,但响应结构不同。前者通常包含 found: false;后者返回 index_not_found_exception 错误对象。应用不能只判断状态码,还应检查响应体中的错误类型。
| 场景 | HTTP 状态 | 关键字段 |
|---|---|---|
| 文档存在 | 200 | found: true 与 _source |
| 文档不存在 | 404 | found: false |
| 索引不存在 | 404 | error.type: index_not_found_exception |
删除指定文档
删除接口只需要索引名和文档 ID,不需要提交请求体。成功删除已存在文档时,result 为 deleted。
DELETE /products-demo/_doc/1001预期结果(仅列关键字段)
{
"_index": "products-demo",
"_id": "1001",
"result": "deleted"
}删除成功通常返回 HTTP 200 OK。再次删除同一个 ID 时,通常会返回 HTTP 404 Not Found,且 result 为 not_found,表示目标已不存在,而不是服务器执行异常。
需要防止并发误删时,可以把读取或写入响应中的 _seq_no 与 _primary_term 作为条件传给删除请求。若文档已被其他请求修改,条件删除会返回 409 冲突,而不是删除新版本。
验证删除结果
删除完成后再次读取同一 ID,应该得到 found: false。这是比只检查删除响应更可靠的验收方式。
GET /products-demo/_doc/1001预期结果
{
"_index": "products-demo",
"_id": "1001",
"found": false
}删除文档不会立即从底层段文件中物理清除旧数据。Elasticsearch 会先把旧版本标记为删除,并在后续段合并过程中回收空间;对应用而言,删除成功后该 ID 已不可读取。
常见错误与处理
把 DELETE /products-demo 写成删除文档请求会删除整个索引及其中全部文档,风险远高于 DELETE /products-demo/_doc/1001。执行前必须同时核对索引名、_doc 路径段和文档 ID。
如果写入时使用了自定义路由参数,读取和删除时也必须提供相同的 routing 值,否则请求可能定位到错误分片并表现为文档不存在。普通入门示例没有设置自定义路由,不需要额外参数。
本课总结
- 按 ID 读取文档时,存在结果通过
found: true和_source表达 - 404 既可能表示文档不存在,也可能表示索引不存在,必须结合响应体判断
- 删除后应再次读取验证,并避免把删除文档路径误写成删除索引路径
下一课预告
下一课将继续学习文档更新与批量操作,比较整文档替换、局部更新和一次提交多条写入请求的适用场景。