1. 前言：当文档需要"动手术"

在Elasticsearch的日常使用中，文档就像医院里的患者——有些需要定期体检（查询），有些需要打补丁（更新），还有些则需要"出院"（删除）。今天咱们就穿上白大褂，用C#这把"手术刀"，通过NEST客户端来操练文档的更新与删除操作。放心，这次"手术"绝对无痛且充满趣味！

2. 环境准备：安装手术工具

在开始前，咱们先准备好"手术室"：

# 在NuGet中安装NEST客户端
Install-Package NEST -Version 7.17.5

（注意：本文示例基于Elasticsearch 7.x版本和NEST 7.17.5，建议保持版本一致性）

3. 连接医院：建立ES客户端

var settings = new ConnectionSettings(new Uri("http://localhost:9200"))
    .DefaultIndex("patient_records") // 设置默认索引
    .EnableDebugMode();             // 调试模式方便排查问题

var client = new ElasticClient(settings);

这里的patient_records就像医院的档案室，所有病患记录都存放在这里。

4. 更新操作：给文档打补丁

4.1 全量更新（PUT式更新）

// 创建患者实体类
public class Patient 
{
    public int Id { get; set; }
    public string Name { get; set; }
    public int Age { get; set; }
    public string Diagnosis { get; set; }
}

var updatedPatient = new Patient 
{
    Id = 1001,
    Name = "张三",
    Age = 35,
    Diagnosis = "急性肠胃炎（已康复）"
};

var response = client.Update<Patient, object>(
    updatedPatient.Id, 
    u => u.Doc(updatedPatient));

if (!response.IsValid)
{
    Console.WriteLine($"更新失败：{response.DebugInformation}");
}

这相当于给患者的档案袋整个换新内容，适合需要完整替换的场景。

4.2 局部更新（手术刀式精准修改）

var updateResponse = client.Update<Patient, object>(
    1001, 
    u => u
        .Doc(new { Diagnosis = "慢性胃炎（复查中）" }) // 只修改诊断信息
        .RetryOnConflict(3) // 冲突重试3次
        .Refresh(Refresh.True)); // 立即刷新可见

if (updateResponse.Result == Result.Updated)
{
    Console.WriteLine("病历更新成功！新诊断信息已记录");
}

这种更新就像只修改病历的某一行，其他信息保持不动，特别适合频繁修改部分字段的场景。

5. 删除操作：办理出院手续

5.1 按ID删除（精准移除）

var deleteResponse = client.Delete<Patient>(1001, d => d
    .Routing("hospital_a") // 指定路由值
    .Refresh(Refresh.WaitFor));

if (deleteResponse.Result == Result.Deleted)
{
    Console.WriteLine("患者1001的档案已成功归档至历史库");
}
else if (deleteResponse.Result == Result.NotFound)
{
    Console.WriteLine("找不到该患者档案，可能已办理出院");
}

这就相当于把某个患者的档案从当前档案室转移到历史档案库。

5.2 批量删除（集体出院）

var idsToDelete = new List<int> { 1002, 1003, 1004 };

var bulkRequest = new BulkRequest
{
    Operations = idsToDelete
        .Select(id => new BulkDeleteOperation<Patient>(id))
        .Cast<IBulkOperation>().ToList()
};

var bulkResponse = client.Bulk(bulkRequest);

if (bulkResponse.Errors)
{
    var failedIds = bulkResponse.ItemsWithErrors
        .Select(i => i.Id)
        .ToList();
    Console.WriteLine($"以下ID删除失败：{string.Join(",", failedIds)}");
}

批量操作就像同时处理多个出院申请，大幅提升效率。

6. 应用场景剖析

6.1 实时数据看板

在医疗监控系统中，当患者的实时体征数据发生变化时，使用局部更新快速修改特定指标值，保持仪表盘数据的及时性。

6.2 合规性数据清理

根据《医疗数据存储规范》要求，对超过保存期限的病历记录进行定时批量删除，使用DeleteByQuery配合时间范围查询。

6.3 业务状态流转

住院患者的"入院->治疗->出院"状态变更，通过更新操作修改status字段，配合pipeline实现状态变更通知。

7. 技术选型优劣谈

7.1 优势亮点

  • 强类型支持：编译时类型检查比直接使用JSON更安全
  • 智能重试机制：内置的RetryOnConflict解决并发冲突
  • DSL映射：将ES查询语法转化为流畅的C#表达式
  • 批量处理：Bulk API实现高效批量操作

7.2 需要注意的"暗礁"

  • 版本兼容性：ES版本升级可能导致API变更
  • 网络开销：频繁的单文档操作不如批量请求高效
  • 事务缺失：不像关系型数据库支持ACID事务
  • 映射管理：字段类型变更需要重建索引

8. 避坑指南：前辈的经验之谈

8.1 更新策略选择

  • 当文档超过1MB时，优先考虑局部更新
  • 使用_source字段控制返回数据量
  • 重要字段更新建议使用version参数

8.2 删除操作安全锁

// 安全删除示例
client.DeleteByQuery<Patient>(d => d
    .Query(q => q
        .DateRange(r => r
            .Field(f => f.CreateTime)
            .LessThan(DateTime.UtcNow.AddYears(-10))))
    .Conflicts(Conflicts.Proceed) // 忽略版本冲突
    .WaitForCompletion());

这种历史数据清理操作建议在业务低峰期执行。

9. 关联技术：手术刀旁的助手

9.1 版本控制

使用IfPrimaryTerm和IfSeqNumber实现乐观锁：

client.Update<Patient, object>(1001, u => u
    .IfPrimaryTerm(5)
    .IfSequenceNumber(10)
    .Doc(new { Status = "出院" }));

9.2 脚本更新

复杂更新逻辑可以使用Painless脚本：

client.Update<Patient, object>(1001, u => u
    .Script(s => s
        .Source("ctx._source.visit_count += params.count")
        .Params(p => p.Add("count", 1))
    ));

10. 总结：成为ES文档的"主治医师"

通过本文的"临床教学"，相信你已经掌握了使用C#和NEST操作ES文档的核心技能。记住几个关键点：

  1. 更新就像调药方——该全换就全换，该微调就微调
  2. 删除如同做手术——精准下刀，注意术后护理（数据备份）
  3. 批量操作是法宝——能批量就别单条处理

最后送大家一句代码界的"希波克拉底誓言"：先备份，后操作；先测试，后上线。祝各位在Elasticsearch的海洋中乘风破浪！