NoSQL 与搜索 / 系统课时

读取与删除文档

读取与删除文档

本课围绕文档 ID 完成读取、存在性判断、删除和删除后验证,并通过 HTTP 状态与响应体区分“文档不存在”“索引不存在”和“删除成功”三类结果。

学习目标

  • 能使用索引名和文档 ID 精确读取数据
  • 能删除指定文档并验证删除结果
  • 能根据状态码、found 和 result 判断资源状态

准备测试文档

为了保证本课可以独立跟做,先向 products-demo 写入一条 ID 为 1001 的商品文档。索引不存在时,Elasticsearch 通常会自动创建普通索引,但生产环境更推荐提前定义映射和索引模板。

http
PUT /products-demo/_doc/1001
{
  "name": "机械键盘",
  "price": 399.0,
  "in_stock": true
}

预期结果(仅列关键字段)

json
{
  "_index": "products-demo",
  "_id": "1001",
  "_version": 1,
  "result": "created"
}

如果该 ID 已存在,result 可能为 updated,_version 也可能大于 1。这不会影响后续读取与删除练习,只要请求成功即可。

读取存在的文档

文档读取接口使用 GET /<index>/_doc/<id>。它直接按 ID 定位文档,不执行全文检索,也不会返回相关性评分。

http
GET /products-demo/_doc/1001

预期结果(省略版本与序列号字段)

json
{
  "_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。

http
GET /products-demo/_doc/9999

预期结果

json
{
  "_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。

http
DELETE /products-demo/_doc/1001

预期结果(仅列关键字段)

json
{
  "_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。这是比只检查删除响应更可靠的验收方式。

http
GET /products-demo/_doc/1001

预期结果

json
{
  "_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 既可能表示文档不存在,也可能表示索引不存在,必须结合响应体判断
  • 删除后应再次读取验证,并避免把删除文档路径误写成删除索引路径

下一课预告

下一课将继续学习文档更新与批量操作,比较整文档替换、局部更新和一次提交多条写入请求的适用场景。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

读取与删除文档

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通