EFCore.BulkExtensions 10: how to update only selected properties of an Owned entity?

在 Entity Framework Core 开发中，Owned 实体（如值对象 Value Object）的有效管理一直是开发者关注的焦点。近期发布的 EFCore.BulkExtensions 10 版本带来了一个备受期待的功能——支持仅更新 Owned 实体中的选定属性，从而显著提升批量操作效率并减少不必要的重复查询。本文将从实践角度解析这一新特性的实现方法、适用场景与注意事项。

背景：Owned 实体的批量更新痛点

Owned 实体是 EF Core 中用于表示值对象的核心机制，通常与所属实体共享主键，例如订单实体中的 ShippingAddress（地址值对象）或用户实体中的 Profile（个人资料值对象）。在传统批量更新中，开发者常面临两大挑战：

全量替换限制：默认的批量更新操作要求替换整个 Owned 实体，即使只需修改其中一两个属性（如地址中的 City 字段），也必须传递完整对象；
性能开销：EF Core 的默认 SaveChanges 会逐条生成 UPDATE 语句，且必须加载完整实体到内存，导致数据库连接压力增大。

EFCore.BulkExtensions 作为社区广泛采用的批量操作库，此前版本已支持实体的批量插入、更新和删除，但对 Owned 实体的部分属性更新支持有限。V10 版本通过引入 Update 方法的属性选择器，彻底解决了这一限制。

解决方案：使用 `Update` 方法的属性选择器

在最新版本中，Update 方法新增了 expression 参数，允许开发者通过 lambda 表达式指定仅更新 Owned 实体的某些属性。以下是一个典型示例：

假设我们有 Order 实体与 ShippingAddress（Owned 实体）：

public class Order
{
    public int Id { get; set; }
    public ShippingAddress ShippingAddress { get; set; } // 值对象
}

[Owned]
public class ShippingAddress
{
    public string Street { get; set; }
    public string City { get; set; }
    public string ZipCode { get; set; }
}

现在需要批量更新订单的城市（City）和邮编（ZipCode），但保持街道（Street）不变：

using EFCore.BulkExtensions;

// 准备更新数据（仅需提供要更新的属性）
var updates = new List<Order>
{
    new Order { Id = 1, ShippingAddress = new ShippingAddress { City = "北京", ZipCode = "100000" } },
    new Order { Id = 2, ShippingAddress = new ShippingAddress { City = "上海", ZipCode = "200000" } }
};

// 执行批量部分更新
context.BulkUpdate(updates, options => 
{
    options.PropertiesToUpdate = new List<string> { "ShippingAddress.City", "ShippingAddress.ZipCode" };
});

关键点：PropertiesToUpdate 列表中的属性路径必须包含导航属性名称（如 ShippingAddress.City），否则库将无法正确映射到 Owned 实体的嵌套字段。V10 版本内部会将此路径解析为 SQL 中的单表更新列（Owned 实体通常与父实体同表存储，如 Order_ShippingAddress_City），因此生成的 SQL 类似：

UPDATE Orders 
SET ShippingAddress_City = @city, ShippingAddress_ZipCode = @zip
WHERE Id IN (1, 2);

进阶用法：条件更新与复合属性

对于更复杂的场景，比如需要根据特定条件更新 Owned 实体中的部分属性，可以结合 BulkUpdate 的其他选项。例如仅更新订单金额大于 1000 的地址记录：

context.BulkUpdate(updates.Where(o => o.TotalAmount > 1000).ToList(), 
    options => 
    {
        options.PropertiesToUpdate = new List<string> { "ShippingAddress.Street" };
        options.PropsToExclude = null;
    });

此外，如果 Owned 实体包含嵌套 Owned 实体（如 Address.Coordinates 中的 Latitude），同样支持多级属性路径：

"Address.Coordinates.Latitude"

注意事项与性能考量

数据库列映射：Owned 实体的属性在数据库中通常存储为“前缀 + 属性名”的列。确保 PropertiesToUpdate 中的路径与 EF Core 的约定一致（默认使用导航属性名加下划线）。若使用了自定义列名，需用 [Column] 特性标记。
数据一致性：部分更新时未指定的 Owned 属性将被保留原值。但如果 Owned 实体为不可变类型（如 record），EF Core 的行为可能不同，建议始终使用可变类。
批量大小：虽然 BulkUpdate 性能优越，但仍需注意一次更新的记录数过大可能导致数据库锁。建议分批处理（每批 1000-5000 条），尤其是 Owned 实体包含大量属性时。
依赖项版本：EFCore.BulkExtensions 10 与 EF Core 6.0 及以上版本兼容。请确保项目中的 NuGet 包同步更新。

总结

EFCore.BulkExtensions 10 对 Owned 实体部分属性更新的支持，弥补了 EF Core 本身在处理值对象批量修改时的不足。通过简单的属性选择器，开发者可以避免加载整个实体、减少网络往返，并生成高效的批量 UPDATE 语句。对于电商、物流等需要高频更新地址、配置等值对象的场景，该特性尤为实用。未来，社区还计划支持更复杂的表达式树过滤和条件更新，进一步简化批量操作的开发难度。

如果你正在寻找既能保持代码优雅又能实现高性能批量数据更新的解决方案，不妨立即升级试试。更多细节可查阅官方 GitHub 仓库中的文档与示例。

背景：Owned 实体的批量更新痛点

解决方案：使用 Update 方法的属性选择器

进阶用法：条件更新与复合属性

注意事项与性能考量

总结

相关阅读

解决方案：使用 `Update` 方法的属性选择器