表拆分Table Splitting

EF Core 允许将两个或多个实体映射到单个行。 这称为 “表拆分“ 或 “表共享“。

配置Configuration

若要使用表拆分，则需要将多个实体类型映射到同一个表中，将主键映射到相同的列，并且在同一个实体类型的主键与另一个实体类型的主键之间配置至少一个关系。

表拆分的常见方案是只使用表中的部分列，以获得更好的性能或封装。

在此示例中 Order 表示 DetailedOrder的子集。

public class Order
{
    public int Id { get; set; }
    public OrderStatus? Status { get; set; }
    public DetailedOrder DetailedOrder { get; set; }
}

public class DetailedOrder
{
    public int Id { get; set; }
    public OrderStatus? Status { get; set; }
    public string BillingAddress { get; set; }
    public string ShippingAddress { get; set; }
    public byte[] Version { get; set; }
}

除了所需的配置之外，我们还 Property(o => o.Status).HasColumnName("Status") 将 DetailedOrder.Status 映射到与 Order.Status相同的列。

modelBuilder.Entity<DetailedOrder>(dob =>
{
    dob.ToTable("Orders");
    dob.Property(o => o.Status).HasColumnName("Status");
});
modelBuilder.Entity<Order>(ob =>
{
    ob.ToTable("Orders");
    ob.Property(o => o.Status).HasColumnName("Status");
    ob.HasOne(o => o.DetailedOrder).WithOne()
        .HasForeignKey<DetailedOrder>(o => o.Id);
});

提示

有关更多上下文，请参阅完整的示例项目。

用法Usage

使用表拆分来保存和查询实体的方式与其他实体相同：

using (var context = new TableSplittingContext())
{
    context.Database.EnsureDeleted();
    context.Database.EnsureCreated();
    context.Add(new Order
    {
        Status = OrderStatus.Pending,
        DetailedOrder = new DetailedOrder
        {
            Status = OrderStatus.Pending,
            ShippingAddress = "221 B Baker St, London",
            BillingAddress = "11 Wall Street, New York"
        }
    });
    context.SaveChanges();
}
using (var context = new TableSplittingContext())
{
    var pendingCount = context.Orders.Count(o => o.Status == OrderStatus.Pending);
    Console.WriteLine($"Current number of pending orders: {pendingCount}");
}
using (var context = new TableSplittingContext())
{
    var order = context.DetailedOrders.First(o => o.Status == OrderStatus.Pending);
    Console.WriteLine($"First pending order will ship to: {order.ShippingAddress}");
}

可选依赖实体Optional dependent entity

备注

EF Core 3.0 中引入了此功能。

如果依赖实体使用的所有列都 NULL 在数据库中，则查询时将不会创建该实体的任何实例。 这允许对一个可选的依赖实体建模，其中主体的关系属性将为 null。 请注意，这也会导致所有依赖属性均为可选，并设置为 null，这可能不是预期的。

并发令牌Concurrency tokens

如果共享表的任何实体类型都有并发标记，则还必须将其包含在所有其他实体类型中。 当只更新映射到同一个表中的一个实体时，必须使用此值来避免陈旧并发令牌值。

若要避免向使用代码公开并发标记，可以将其创建为影子属性：

modelBuilder.Entity<Order>()
    .Property<byte[]>("Version").IsRowVersion().HasColumnName("Version");
modelBuilder.Entity<DetailedOrder>()
    .Property(o => o.Version).IsRowVersion().HasColumnName("Version");