ElasticSearch更新文档是否需提交全量字段的问题咨询

首先要明确：ES针对文档写入提供了两类逻辑完全不同的接口，相关疑惑本质是混淆了两类接口的行为差异，两类接口的字段要求、同ID文档处理规则完全不一样：

• 全量索引接口（Index API）：请求格式为 PUT /<目标索引名>/_doc/<指定文档ID>
  这个接口的核心逻辑是文档级全量替换：如果指定ID的文档已经存在，ES会直接标记旧文档为删除状态，用你本次请求携带的字段内容生成全新的文档落盘。旧文档里所有没在本次请求里出现的字段会直接丢失，不会自动保留。
  举个直观例子：假设索引里已有ID为1的文档，内容为

  {"user_id": 1, "username": "test", "age": 25, "city": "上海"}
  

  如果你调用Index接口只传{"age":26}，最终落盘的文档就只会剩下{"age":26}，其余三个字段会全部消失。
• 局部更新接口（Update API）：请求格式为 POST /<目标索引名>/_update/<指定文档ID>
  这个接口是专门为局部字段更新设计的：你不需要携带文档的全部字段，只需要把待修改的字段放在doc参数下传入即可。ES收到请求后会先读取对应ID的旧文档内容，将你传入的新字段和旧文档的原有字段合并，再把合并后的完整文档重新写入，未在请求中出现的旧字段会完整保留。
  还是以上面的文档为例，调用Update接口传入如下内容：

  {"doc": {"age":26}}
  

  最终落盘的文档会是{"user_id": 1, "username": "test", "age": 26, "city": "上海"}，除了你指定修改的age字段，其余字段完全不受影响。

对你提出的两个问题的明确答复 #

1. 请求携带字段的要求完全取决于你选用的接口：

• 如果用Index全量索引接口：要保留原有所有字段就必须携带全量字段；如果你的目的就是替换整个文档为新内容，按新文档的实际字段携带即可。
• 如果用Update局部更新接口：不需要携带全量字段，仅传入待更新的字段就可以完成修改。

2. 同ID文档的覆盖规则同样和接口绑定：

• 用Index接口时，新请求会覆盖该ID下的全部原有数据，不会自动保留未传字段。这种场景下如果想保留其他字段就必须提交全量字段，只传待更新字段会导致其余字段丢失，不可行。
• 用Update接口时，新请求不会覆盖全量原有数据，仅会更新请求中列出的字段，不需要提交全量字段，仅提供待更新字段是完全可行的。

补充说明：受ES底层段（Segment）不可变的存储机制限制，即使用Update接口做局部更新，ES内部实际执行的也是「读取旧文档→合并字段→写入新文档→标记旧文档删除」的流程，不存在原文件上的原地修改，但这个内部逻辑对上层使用是透明的，不需要在业务侧做额外处理。

内容的提问来源于stack exchange，提问作者Louis Phan