NoSQL 与搜索 / 系统课时

并发更新控制

并发更新控制

本课解决多个客户端同时修改同一文档时的覆盖问题。你将使用 _seq_no 与 _primary_term 组成版本条件,让过期请求明确失败,而不是悄悄把新数据改回旧值。

学习目标

  • 理解序列号与主分片任期分别解决什么问题
  • 使用 if_seq_no 和 if_primary_term 执行条件更新
  • 识别版本冲突,并选择重试或返回业务失败

为什么普通更新会丢数据

假设客户端 A 和客户端 B 同时读取库存 10。A 售出 1 件并写入 9,B 也基于旧值计算后写入 9。两次请求都成功,但实际售出 2 件,正确库存应为 8。问题不在于 Elasticsearch 无法并发写入,而在于第二次写入没有证明自己基于最新数据。

Elasticsearch 为每次文档变更分配递增的 _seq_no。主分片每次重新选举后,_primary_term 会变化。两者一起标识“这份文档状态来自哪一代主分片、处于哪个写入位置”,可以防止旧主分片或旧读取结果覆盖新状态。

乐观并发控制的读取与条件写入流程

创建可重复的测试数据

下面命令重建测试索引,并写入一条库存文档。示例假设 Elasticsearch 位于本机 9200 端口,未启用身份认证;实际环境应替换地址和认证参数。

bash
curl -s -X DELETE "http://localhost:9200/inventory_occ_demo" > /dev/null
curl -s -X PUT "http://localhost:9200/inventory_occ_demo" \
  -H "Content-Type: application/json" \
  -d '{"mappings":{"properties":{"stock":{"type":"integer"}}}}' > /dev/null
curl -s -X PUT "http://localhost:9200/inventory_occ_demo/_doc/stock-1?refresh=true" \
  -H "Content-Type: application/json" \
  -d '{"stock":10}'

预期结果(保留关键字段)

json
{
  "_index": "inventory_occ_demo",
  "_id": "stock-1",
  "_version": 1,
  "result": "created",
  "_seq_no": 0,
  "_primary_term": 1
}

如果索引曾被系统自动恢复或主分片发生过切换,_primary_term 可能不是 1。后续请求应始终使用读取结果中的实际值。

读取并携带版本条件更新

先读取文档,记录响应中的 _seq_no 和 _primary_term。

bash
curl -s "http://localhost:9200/inventory_occ_demo/_doc/stock-1"

预期结果(保留关键字段)

json
{
  "_index": "inventory_occ_demo",
  "_id": "stock-1",
  "_version": 1,
  "_seq_no": 0,
  "_primary_term": 1,
  "found": true,
  "_source": {
    "stock": 10
  }
}

接着把这两个值放入更新请求的查询参数。只有文档仍处于该状态时,更新才会成功。

bash
curl -s -X POST \
  "http://localhost:9200/inventory_occ_demo/_update/stock-1?if_seq_no=0&if_primary_term=1&refresh=true" \
  -H "Content-Type: application/json" \
  -d '{"doc":{"stock":9}}'

预期结果(保留关键字段)

json
{
  "_index": "inventory_occ_demo",
  "_id": "stock-1",
  "_version": 2,
  "result": "updated",
  "_seq_no": 1,
  "_primary_term": 1
}

此时再使用旧条件提交更新,Elasticsearch 会拒绝请求,而不是覆盖刚写入的库存。

bash
curl -s -i -X POST \
  "http://localhost:9200/inventory_occ_demo/_update/stock-1?if_seq_no=0&if_primary_term=1" \
  -H "Content-Type: application/json" \
  -d '{"doc":{"stock":8}}'

预期结果

text
HTTP/1.1 409 Conflict

响应体中的错误类型为 version_conflict_engine_exception。这表示条件不再成立,客户端必须重新读取最新文档后再决定是否重算并重试。

冲突后的处理策略

乐观并发控制不会自动判断业务意图。遇到 409 时,计数累加、库存扣减等可交换操作,通常适合重新读取并有限重试;用户编辑资料、审批状态变更等覆盖风险较高的操作,更适合把冲突返回给调用方,让用户确认最新状态。

retry_on_conflict 适用于使用脚本或局部更新、且业务允许按最新值重复计算的场景。它只是重新执行更新,不等价于携带明确的 _seq_no 与 _primary_term 条件,也不应设置成无限重试。高冲突热点应进一步考虑拆分文档、队列串行化或在业务层聚合写入。

验证最终状态

最后读取文档,确认失败的旧请求没有覆盖成功结果。

bash
curl -s "http://localhost:9200/inventory_occ_demo/_doc/stock-1?_source=stock"

预期结果(保留关键字段)

json
{
  "_index": "inventory_occ_demo",
  "_id": "stock-1",
  "_version": 2,
  "_seq_no": 1,
  "_primary_term": 1,
  "found": true,
  "_source": {
    "stock": 9
  }
}

本课总结

  • _seq_no 标识写入顺序,_primary_term 标识主分片任期,两者共同构成可靠的并发条件
  • if_seq_no 与 if_primary_term 能把过期更新转换为明确的 409 冲突
  • 冲突后应按业务语义选择重算重试、返回用户确认或降低热点写入竞争

下一课预告

下一课将把索引映射变更与线上迁移结合起来,使用 Reindex API 和别名完成无停机重建与切换。

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

目录与阅读设置

阅读设置

17

记录一个想法

并发更新控制

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

登录哪都通